Global Settings
Configure these in Settings (Cmd+Shift+P).
Appearance
| Setting | Default | Description |
|---|---|---|
| Theme | Dark | Color theme: Dark, Light, or System |
| Font Size | 13 | Base font size in pixels |
| Font Family | JetBrains Mono | Choose from System, JetBrains Mono, Fira Code, or Geist Mono |
| Colored Sidebar Diffs | Off | Show colored diff indicators in the workspace sidebar |
| Terminal Font Size | 12 | Terminal font size in pixels |
Behavior
| Setting | Default | Description |
|---|---|---|
| Send Messages With | Enter | Send key: Enter or Shift+Enter |
| Sound Effects | Off | Enable sound effects |
| Auto-Convert Long Text | On | Automatically convert long text to file attachments |
| Auto-Start on Login | Off | Launch Commander when you log in to macOS |
| Restore Windows on Launch | On | Restore open windows when the app restarts |
| Check for Updates | On | Automatically check for new versions |
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 |
| Orchestrator Update | On | The orchestrator has an update |
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 |
| Thinking Mode | On | Enable extended thinking |
| Fast Mode | Off | Use fast output mode |
| Effort Level | High | Agent thoroughness: Low, Medium, High, or Max |
| Plan Mode | Off | Require step-by-step plan approval before execution |
| Auto-Resume on Launch | Off | Automatically resume paused agents when the app starts |
Orchestrator
| Setting | Default | Description |
|---|---|---|
| Orchestrator Enabled | Off | Enable the per-repo orchestrator meta-agent |
| Sampling Interval | 30 seconds | How often the orchestrator checks for events |
| Custom Instructions | (empty) | Additional instructions for the orchestrator |
Budget
| Setting | Default | Description |
|---|---|---|
| Daily Budget | Unlimited | Maximum daily spend in USD |
| Alert Thresholds | 50%, 80%, 100% | Notify at these percentages of the daily budget |
CI / PR Automation
| Setting | Default | Description |
|---|---|---|
| Auto-Resolve PR Comments | Off | Automatically resolve PR review comments |
| Auto-Fix CI | Off | Automatically attempt to fix CI failures |
| CI Fix Max Retries | 3 | Maximum retry attempts for auto-fixing CI |
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, timeout, and an optional flag to allow skipping on failure.