> ## Documentation Index > Fetch the complete documentation index at: https://commander-docs.cyshel.com/llms.txt > Use this file to discover all available pages before exploring further. # Configuration > All global and repository settings with defaults. ## 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 | You can enable or disable notifications per type: | 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 |