Type settings and press Enter, or press cmd+, in the frame (alt+, in a
terminal). One row per setting, the current value beside it. Enter on a row
to change it.
Typing filters the rows. Each word you type must be in a row's title or in
the value beside it, in any order and any case: key api finds API key, and
nvim finds Editor when that is the editor. ai finds the API URL and API
key rows too. The letters of a word need only be there in order: akey
finds API key as well. The best match comes first: a word as you typed it
ahead of one with letters in between, the start of a word ahead of its
middle, a title ahead of a value. Extensions and each setting's choices
filter the same way, and so does every other view.
| setting | in the file | what it changes |
|---|---|---|
| Hotkey | hotkey | the key that shows the panel |
| Preview width | preview | where the divider between the list and the preview sits, in percent |
| AI model | ai | which command answers in Ask AI |
| Web search for AI | web | whether that model may search the web |
| API URL | ai_url | the server an openai: or lmstudio: model talks to |
| API key | ai_key | the key for that server; empty uses OPENAI_API_KEY |
| Editor | editor | what notes, tasks and Edit actions open in, inside the panel |
| Used recently | recent | whether the five things you opened last come first |
| Week starts on | week | monday or sunday: where This week ends in Tasks and Reminders |
| Emoji skin tone | skin | the default tone for emoji |
| Transcript renderer | render | what draws the Ask AI transcript |
| Extensions | off | which extensions are off |
The last row, Open the config folder, shows you the files.
Extensions lists every extension with a box for on or off. Enter turns one off, and its rows leave the root list until you turn it back on. Settings itself cannot be turned off.
In the file that is one line:
off = reminders, tasks
Every value is one line in ~/.config/swoop/config, which you can also edit
by hand:
hotkey = alt+shift+space
preview = 58
editor = nvim
ai = claude
render = glow -s dark
off = reminders
The frame watches that file, so a new hotkey works within a second, with no restart.
| file | what it holds |
|---|---|
~/.config/swoop/ai | a custom AI command, one line |
~/.config/swoop/quicklinks.tsv | your quicklinks |
~/.config/swoop/snippets/ | your snippets, one markdown file each |
~/.config/swoop/emoji.keywords | your own words for emoji |
~/.config/swoop/clipboard.ignore | apps whose copies are never kept |
~/.config/swoop/shell-mac.json | the panel's size and font size |
~/.config/swoop/extensions/ | your own extensions |
XDG_CONFIG_HOME replaces ~/.config when it is set.