Skip to main content

Settings reference

The sidebar groups its panes as App, Workspace, Agents, and Access.

GroupPaneControls
AppGeneralLaunch at login, the welcome tour, diagnostics and crash sharing, and resetOpen
AppAppearanceTheme family and light or dark palettes, image backgrounds, app text size, terminal font, terminal text size, and terminal canvasOpen
AppInterfaceInterface animation, monitor and quick run defaults, a discreet project menu, and whether quick runs and split panes follow you across projectsOpen
AppNotificationsBanners, moving a waiting session to the top, command-completion notices, program-raised notifications, the away summary, and watch patternsOpen
AppSoundSound effects and volume, which sounds play, when they play, and trackpad hapticsOpen
AppKeyboard shortcutsEvery shortcut, grouped as in the menus, with app shortcuts you can rebind or restore to their defaultsOpen
WorkspaceProjectsSmart collapsing, the folders scanned for repositories, and the default IDEOpen
WorkspaceSession presetsRepeatable sessions: a name and emoji, whether each appears in the + Session menu, the shell or agent model it opens with, agent settings, custom context, an opening task, and a command previewOpen
WorkspaceSessionsCustom resume bindings, shell integration, Option as the Meta key, live scrollback depth, paste, close, and quit confirmations, tidying quiet sessions, scrollback restoration, and project session history retentionOpen
WorkspaceSSHSaved SSH targets, importing hosts from your OpenSSH config, the tmux session each reconnects to, and testing a connectionOpen
AgentsProvidersOne card per provider holding its roster switch, install, models, hooks, away compaction where supported, and the Saggar skillOpen
AgentsSupervisionProvider coverage, command preview, automatic-approval safeguards, your own rules, and decision history for Pro and TeamsOpen
AgentsAutomationWhether scheduled jobs catch up runs missed while the Mac was asleep or Saggar was closed, pausing every hook's automatic launches, and the agent a hook investigates withOpen
AccessCLICommand installation, workspace permissions, and terminal self-approvalOpen
AccessMarginal Utility accountSigning in and out, opening the account in the browser, syncing settings across your Macs, and account features such as session summaries and smart namingOpen
AccessRemote controlRemote access level, the signed-in account, relay status, keeping the Mac awake, pairing, paired devices, and recent remote actionsOpen

Open Settings with ⌘,. Its search includes related terms that may not appear in a pane title. See Settings and maintenance for behavior and defaults.