Settings and configuration
Open Settings from the sidebar or press ⌘,. Settings opens in a separate,
nonmodal window, so you can keep working in your project while it stays open.
Pressing ⌘, again brings that window forward.
Choose All projects for app-wide preferences. Choose the project row below it for that project’s overrides. Switch project changes which project you configure without switching the project in your main window. Use Search settings to find a page or control across both scopes.
Settings
Section titled “Settings”Under All projects, the pages cover these controls:
| Page | Controls |
|---|---|
| General | Zoom, Diff layout, and Show cost and token usage |
| Appearance | Canvas, light/dark appearance, Style, Motion, and terminal fonts and configuration |
| Notifications | Native notifications for input, merged pull requests, reclaimed worktrees, and updates |
| Skills | Project and personal Skill inventory; choose an Activation project to set its Skill modes |
| MCP Servers | Server connections and selected tools shared across projects on this Mac |
| Models | Provider sign-in, default models and reasoning, and model visibility in pickers |
| Agents | Decision model, automatic model choice, automatic compaction, and Code Mode |
| Web Search | Search providers and their credentials or instance address |
| Integrations | External editor and terminal choices |
| Storage | Worktree retention, cleanup, leftover processes, and local backup and restore |
| Privacy & data | Optional agent telemetry, database location, and JSON data export |
| Updates | Installed version, update channel, and update checks |
| About | Version, licence, Diagnostics, and Copy report… |
Follow Models and usage, Code Mode,
Theming, or Manage local storage for
those tasks. Subscription usage windows appear in Usage limits beside
⌘K, outside Settings.
Configure
Section titled “Configure”Configure for a project opens that project’s scope in the same Settings window. You can also select the project directly in Settings.
| Page | Controls |
|---|---|
| Overview | Review and reset the project’s global overrides |
| Commands | Project and personal slash-command templates |
| Secrets | Supply, replace, and revoke project credentials |
| Sessions | Chat model and decision-model overrides; inspect repository instruction files |
| Appearance | Project appearance, canvas, style, and terminal overrides |
| Worktrees | Base branch, setup command, and copied files for new ticket worktrees |
Skills and MCP servers live under All projects. Skill activation modes still belong to the project selected in Activation project. MCP server connections and selected tools apply across projects.
Project overrides show their effective value. Where an override has a reset control, open it and choose Revert to global default to follow later app-wide changes again.
See Skills and commands, MCP servers, and Agent authority. Chats and worktrees covers worktree setup. Saved Automations and their Automatic triggers switches live on the Automations page.
Web Search
Section titled “Web Search”In All projects → Web Search, add a credential for Brave or Exa with Add key, or set a SearXNG address with Edit instance. Select the provider’s Default radio control to use it. Saved keys are not shown again; use Replace key or Remove key to change them.
Turn off disables the built-in web search and read tools for new Sessions. It does not disable model requests, Browser Tabs, MCP connections, or commands with network access. See Local data and network access.