Availability
Where to find it
- Account menu (the avatar at the bottom of the icon bar) › Settings, shortcut
⌘,(Windows:Ctrl+,). - In the command menu
⇧⌘P(Windows:Ctrl+Shift+P), search for Settings · section name to jump straight to a section. - Settings entries on other pages open the matching section directly, for example the gear Notification settings in the upper-right corner of the in-app notifications list.
Settings page layout
The left side of the Settings page is the section navigation (you can search section names at the top), and the right side shows the current section. The navigation has three groups: Personal, Integrations and Workspace:Leaving Settings
- Desktop app: click another entry in the icon bar or a session in the sidebar.
- Web app (wide screen): click the back arrow at the top of the navigation, or press
Esc. - Mobile web: after you open a section, Back to settings in the upper-left corner returns to the list.
General
Settings › General is divided, from top to bottom, into: Permissions, Chat, General, System notifications and Updates (desktop app only). Changes save as soon as you select them.Permissions: default permission on this computer
Default permission on this computer sets the permission that sessions running on your device start with.- Sessions on a cloud server use full access by default and are not affected by this setting.
- You can adjust the permission for each session in the composer. This does not change the default here.
- When you switch to Full access, you are asked to confirm first: once on, the agent runs commands without asking for approval and can read all of this project’s secrets.
Chat: messages sent mid-turn
If you send another message while the agent is running, it is handled according to the default here:
Only Claude Code and Codex support steering. Other Harnesses queue messages automatically. For per-message choices while running, see Composer.
General
- You can also switch the language from account menu › Language, or with Switch language to English / 简体中文 in the command menu.
- When Keep in the menu bar is on, the app keeps running in the background after you close the main window and shows system notifications as usual. Click the icon in the menu bar (Windows: notification area) to reopen the window. To quit completely: on macOS, use
⌘Q; on Windows, use Exit in the File menu (pressAltto show the menu bar).
System notifications
The System notifications group contains the System notifications switch, the System permission status, and three alert types: Task completed, Needs your attention and Task issues. See Notifications.Updates
The Updates group appears only in the desktop app. It contains two switches, Automatically check for updates and Automatically download updates, and the version status. See Updates.Appearance
Settings › Appearance: first choose a theme, then choose a display mode (light or dark). The two are independent: for example, if the current setting is Warm Sand + Dark and you select Iris Slate, it becomes Iris Slate + Dark. Changes take effect immediately. Appearance and notification preferences are saved only on the current device (or this browser). On another device, you need to set them again.Themes
Display mode
Other ways to change the appearance
- The Light / Dark / System buttons in the Appearance row of the account menu (they switch only the display mode, not the theme).
- The shortcut
⇧⌘L(Windows:Ctrl+Shift+L) cycles through Light → Dark → System. - Search for Display mode · name or Theme · name in the command menu.