Quick Start
1
Open settings
Press
⌘, to open the settings window.2
Search for a field
Use the built-in search box — it matches labels, descriptions, and keywords, and never returns a row that is currently hidden.
3
Reset a single field
Each row has a per-field reset back to its default.
How It Works
On save, the engine clears its cached agents, so the next turn picks up your new settings immediately.Secrets never reach
settings.json. The api_key is stored in the macOS keychain and stripped before the file is written.General
Models
Chat
Appearance
Safety
See Approvals & Safety for behaviour.
Data
Actions, not stored values:
See Data & Privacy for where data lives.
About
Gating Behaviour
Some rows appear only when another setting has the right value:
Fields marked Requires restart (
base_url, api_key, launch_at_login) say so on the row itself.
Best Practices
Use search instead of scrolling
Use search instead of scrolling
The search box derives from the registry and respects visibility rules, so it never surfaces a hidden row. Type a keyword like “proxy” or “secret” to jump straight to a field.
Reset one field at a time
Reset one field at a time
Per-field reset restores a single setting to its default without touching the rest — safer than a full reset.
Restart after changing model credentials
Restart after changing model credentials
base_url and api_key are marked “requires restart”. Relaunch the app after changing them so the engine picks up the new endpoint or key.Related
Models & API Keys
Model pill, sampling, and keychain storage
Data & Privacy
Where settings and secrets live