Skip to content

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.

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 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.

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.