Skip to main content

​
Global Settings

Configure these in Settings (Cmd+Shift+P).

​
Appearance

SettingDefaultDescription
ThemeDarkColor theme: Dark, Light, or System. Toggle with Cmd+Shift+T.
Colored Sidebar DiffsOffAlways show line change colors in the sidebar, even for unselected workspaces
Markdown StyleDefaultRendering style for agent markdown output
Mono FontGeist MonoMonospace font for code and agent output
Font Size13Base font size in pixels
Terminal Font Size12Terminal font size in pixels

​
Behavior

SettingDefaultDescription
Send Messages WithEnterSend key: Enter or Shift+Enter. The other key inserts a new line.
Desktop NotificationsOnEnable macOS notifications when agents finish or need input
Sound EffectsOffPlay a sound when agents finish working
Auto-Convert Long TextOnConvert pasted text over 5,000 characters into text attachments
Always Show Context UsageOffAlways display the context window fill percentage. By default, only shown when above 70%.
Screenshots Folder(none)Path to a folder Commander watches for new screenshots

​
Startup

SettingDefaultDescription
Auto-Start on LoginOffLaunch Commander when you log in to macOS
Restore Windows on LaunchOffReopen previous windows when the app restarts
Check for UpdatesOffAutomatically check for new versions
Auto-Download UpdatesOnDownload updates in the background when available

​
Notifications

SettingDefaultDescription
Notifications EnabledOnEnable macOS notifications
Notification SoundOnPlay a sound with notifications
You can enable or disable notifications per type:
TypeDefaultTrigger
Agent WaitingOnAn agent needs your input
Agent ErrorOnAn agent encountered an error
Agent Rate LimitedOnAn agent hit a rate limit
CI FailedOnCI checks failed on a linked PR
PR CommentsOnNew review comments on a linked PR
Manager UpdateOnThe manager has an update

​
Developer

SettingDefaultDescription
Enable LoggingOffWrite debug-level logs to disk. Useful for troubleshooting.

​
Privacy

SettingDefaultDescription
Share Anonymous Usage DataOnHelp improve Commander by sending anonymous usage analytics

​
Repository Settings

Configure per-repository settings in Settings after selecting a repository.

​
Agent Defaults

SettingDefaultDescription
Default ModelSonnetDefault model for new agents (Opus, Sonnet, or Haiku)
Thinking ModeOnEnable extended thinking
Fast ModeOffStart new chats in fast output mode
Effort LevelHighAgent thoroughness: Low, Medium, High, or Max
Plan ModeOffStart new chats in plan mode (propose steps for approval before executing)
Use Claude Code with ChromeOffAllow agents to control your Chrome browser. Requires the Claude Code Chrome extension.
Max Agents per WorkspaceNo limitMaximum concurrent agents per workspace (1-20 or no limit)
Auto-Resume on LaunchOffAutomatically resume paused agents when the app starts
Daily Budget (USD)UnlimitedMaximum daily spend in USD per repository
Claude AccountDefaultWhich Claude account to use for this repository (when multiple accounts are configured)

​
Review (Coming Soon)

SettingDefaultDescription
Review ModelSonnetModel used for automated code reviews
Thinking ModeOnEnable extended thinking for reviews

​
Manager

SettingDefaultDescription
Manager EnabledOffEnable the per-repo manager hierarchy
Sampling Interval30 secondsHow often the manager checks for events and reflects on progress
Custom Instructions(empty)Persistent instructions for the manager (e.g., “Prioritize bug fixes over new features”)

​
Awareness

SettingDefaultDescription
Awareness EnabledOnPersistent memory system for managers — evaluates workspace state and takes proactive action
Decision ModelHaiku 4.5Fast model that decides when to update awareness
Writer ModelSonnet 4.6Model that synthesizes awareness context text

​
Budget

SettingDefaultDescription
Daily BudgetUnlimitedMaximum daily spend in USD
Alert Thresholds50%, 80%, 100%Configurable percentages of the daily budget that trigger notifications

​
CI / PR Automation

SettingDefaultDescription
Auto-Resolve PR CommentsOffAutomatically resolve PR review comments by sending them to an agent
Auto-Fix CIOffAutomatically attempt to fix CI failures on linked PRs
CI Fix Max Retries3Maximum retry attempts for auto-fixing CI

​
Environments

SettingDefaultDescription
Environment ModeNoneHow to provision environments: None, Local Docker, or GitHub Codespace
Auto-ProvisionOffAutomatically create the environment when a new workspace is created
Devcontainer ConfigAuto-detectPath to devcontainer.json — auto-detected if only one exists in the repo
Volume PersistenceOnKeep data volumes across environment rebuilds
Offset Ports on ConflictOnAuto-assign different local ports when multiple environments use the same ports
CPU Limit (Local only)UnlimitedMaximum CPU cores for local Docker environments
Memory Limit (Local only)UnlimitedMaximum memory in MB for local Docker environments
Machine Type (Codespace only)2-coreCodespace VM size: 2-core through 32-core
Idle Timeout (Codespace only)30 minMinutes of inactivity before the codespace auto-stops

​
Setup Scripts

Configure scripts that run automatically when a new workspace is created (e.g., pnpm install, database migrations). Each script has a name, command, args, timeout, and an optional flag to allow skipping on failure. Setup scripts support dynamic template variables:
VariableDescription
{{workspace.index}}Numeric index of the workspace
{{workspace.branch}}Branch name
{{issue.type}}Type of linked Linear issue
{{issue.labels}}Labels from linked Linear issue

​
GitHub Actions

SettingDefaultDescription
Pinned Workflows(none)Workflow IDs pinned for quick access in the workspace view

​
Advanced

SettingDefaultDescription
Prompt Repository Path.claudePath to the directory containing prompt files for agents
Custom Prompts(empty)JSON object with custom prompt templates