Configuration
Settings
Complete guide to ChatML's settings and configuration options.
Access settings with Cmd+, or from the command palette.
General
| Setting | Description | Default |
|---|---|---|
| Workspaces Base Directory | Where session worktrees are stored | ~/Library/Application Support/ChatML/workspaces |
Appearance
| Setting | Description |
|---|---|
| Theme | Light, Dark, or System |
| Font Size | Code and UI font sizing |
AI
| Setting | Description |
|---|---|
| Model | Claude model selection (Opus, Sonnet, Haiku) |
| Fallback Model | Model to use when primary model fails |
| Extended Thinking | Enable/disable extended thinking |
| Max Thinking Tokens | Token budget for extended thinking (default: 16,000) |
| Max Budget (USD) | Cost limit per conversation |
| Max Turns | Turn limit per conversation |
Git
| Setting | Description |
|---|---|
| Branch Prefix | How session branch names are formatted |
| Per-Workspace Overrides | Different prefix per workspace |
Branch Prefix Options
- GitHub username —
username/session-name - Custom prefix —
feat/session-name,fix/session-name, etc. - None —
session-name
Review
| Setting | Description |
|---|---|
| Global Review Prompt | Custom instructions for code review conversations |
| Per-Workspace Prompts | Override review instructions per repository |
Account
| Setting | Description |
|---|---|
| Anthropic API Key | Claude API access (encrypted) |
| GitHub | OAuth connection for PR, CI, issues |
| Linear | OAuth connection for issue tracking |
Advanced
| Setting | Description |
|---|---|
| Environment Variables | Variables passed to agent processes |
| MCP Servers | Custom Model Context Protocol servers |
| PR Templates | Global and per-workspace PR description templates |
| Workspace Config | Setup scripts, run scripts, hooks |