Global Settings
Configure these in Settings (Cmd+Shift+P).
Appearance
| Setting | Default | Description |
|---|---|---|
| Theme | Dark | Color theme: Dark, Light, or System. Toggle with Cmd+Shift+T. |
| Colored Sidebar Diffs | Off | Always show line change colors in the sidebar, even for unselected workspaces |
| Markdown Style | Default | Rendering style for agent markdown output |
| Mono Font | Geist Mono | Monospace font for code and agent output |
| Font Size | 13 | Base font size in pixels |
| Terminal Font Size | 12 | Terminal font size in pixels |
Behavior
| Setting | Default | Description |
|---|---|---|
| Send Messages With | Enter | Send key: Enter or Shift+Enter. The other key inserts a new line. |
| Desktop Notifications | On | Enable macOS notifications when agents finish or need input |
| Sound Effects | Off | Play a sound when agents finish working |
| Auto-Convert Long Text | On | Convert pasted text over 5,000 characters into text attachments |
| Always Show Context Usage | Off | Always 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
| Setting | Default | Description |
|---|---|---|
| Auto-Start on Login | Off | Launch Commander when you log in to macOS |
| Restore Windows on Launch | Off | Reopen previous windows when the app restarts |
| Check for Updates | Off | Automatically check for new versions |
| Auto-Download Updates | On | Download updates in the background when available |
Notifications
| Setting | Default | Description |
|---|---|---|
| Notifications Enabled | On | Enable macOS notifications |
| Notification Sound | On | Play a sound with notifications |
| Type | Default | Trigger |
|---|---|---|
| Agent Waiting | On | An agent needs your input |
| Agent Error | On | An agent encountered an error |
| Agent Rate Limited | On | An agent hit a rate limit |
| CI Failed | On | CI checks failed on a linked PR |
| PR Comments | On | New review comments on a linked PR |
| Manager Update | On | The manager has an update |
Developer
| Setting | Default | Description |
|---|---|---|
| Enable Logging | Off | Write debug-level logs to disk. Useful for troubleshooting. |
Privacy
| Setting | Default | Description |
|---|---|---|
| Share Anonymous Usage Data | On | Help improve Commander by sending anonymous usage analytics |
Repository Settings
Configure per-repository settings in Settings after selecting a repository.Agent Defaults
| Setting | Default | Description |
|---|---|---|
| Default Model | Sonnet | Default model for new agents (Opus, Sonnet, or Haiku) |
| Thinking Mode | On | Enable extended thinking |
| Fast Mode | Off | Start new chats in fast output mode |
| Effort Level | High | Agent thoroughness: Low, Medium, High, or Max |
| Plan Mode | Off | Start new chats in plan mode (propose steps for approval before executing) |
| Use Claude Code with Chrome | Off | Allow agents to control your Chrome browser. Requires the Claude Code Chrome extension. |
| Max Agents per Workspace | No limit | Maximum concurrent agents per workspace (1-20 or no limit) |
| Auto-Resume on Launch | Off | Automatically resume paused agents when the app starts |
| Daily Budget (USD) | Unlimited | Maximum daily spend in USD per repository |
| Claude Account | Default | Which Claude account to use for this repository (when multiple accounts are configured) |
Review (Coming Soon)
| Setting | Default | Description |
|---|---|---|
| Review Model | Sonnet | Model used for automated code reviews |
| Thinking Mode | On | Enable extended thinking for reviews |
Manager
| Setting | Default | Description |
|---|---|---|
| Manager Enabled | Off | Enable the per-repo manager hierarchy |
| Sampling Interval | 30 seconds | How 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
| Setting | Default | Description |
|---|---|---|
| Awareness Enabled | On | Persistent memory system for managers — evaluates workspace state and takes proactive action |
| Decision Model | Haiku 4.5 | Fast model that decides when to update awareness |
| Writer Model | Sonnet 4.6 | Model that synthesizes awareness context text |
Budget
| Setting | Default | Description |
|---|---|---|
| Daily Budget | Unlimited | Maximum daily spend in USD |
| Alert Thresholds | 50%, 80%, 100% | Configurable percentages of the daily budget that trigger notifications |
CI / PR Automation
| Setting | Default | Description |
|---|---|---|
| Auto-Resolve PR Comments | Off | Automatically resolve PR review comments by sending them to an agent |
| Auto-Fix CI | Off | Automatically attempt to fix CI failures on linked PRs |
| CI Fix Max Retries | 3 | Maximum retry attempts for auto-fixing CI |
Environments
| Setting | Default | Description |
|---|---|---|
| Environment Mode | None | How to provision environments: None, Local Docker, or GitHub Codespace |
| Auto-Provision | Off | Automatically create the environment when a new workspace is created |
| Devcontainer Config | Auto-detect | Path to devcontainer.json — auto-detected if only one exists in the repo |
| Volume Persistence | On | Keep data volumes across environment rebuilds |
| Offset Ports on Conflict | On | Auto-assign different local ports when multiple environments use the same ports |
| CPU Limit (Local only) | Unlimited | Maximum CPU cores for local Docker environments |
| Memory Limit (Local only) | Unlimited | Maximum memory in MB for local Docker environments |
| Machine Type (Codespace only) | 2-core | Codespace VM size: 2-core through 32-core |
| Idle Timeout (Codespace only) | 30 min | Minutes 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:
| Variable | Description |
|---|---|
{{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
| Setting | Default | Description |
|---|---|---|
| Pinned Workflows | (none) | Workflow IDs pinned for quick access in the workspace view |
Advanced
| Setting | Default | Description |
|---|---|---|
| Prompt Repository Path | .claude | Path to the directory containing prompt files for agents |
| Custom Prompts | (empty) | JSON object with custom prompt templates |