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, crash sharing, usage analytics, 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, discreet monitor opacity, progress cards, the project menu's docked or overlay mode, a discreet project menu, grouping active projects by folder, whether quick runs and split panes follow you across projects, and showing chat when availableOpen
AppNotificationsBanners, how much to say when commands finish, moving a waiting session to the top, 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, reasoning effort, Codex speed and context window, 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 and the agent review before a close, 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, the context warning threshold and away compaction where supported, and the Saggar skillOpen
AgentsSupervisionRespond or Intercept mode, which providers start supervised, letting Saggar make decisions, hiding "Always allow" choices, provider 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 automatic hook launches, and the agent a hook investigates withOpen
AccessCLIWorkspace-change permissions, command execution consent and its per-session grants, terminal self-approval, and command installationOpen
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.