Settings
Open settings with ⌘/Ctrl + , or from the sidebar. Settings are organized into sections.
General
Section titled “General”| Setting | Description | Default |
|---|---|---|
| Worktree base directory | Directory where new workspaces are created | ~/.claudette/workspaces |
| System tray | Enable/disable system tray integration | Enabled |
| Archive on merge | Automatically archive a workspace when its pull request is merged. See SCM Providers. | Off |
Models
Section titled “Models”Default values applied to all new agent sessions. Per-workspace overrides are available in the chat header.
| Setting | Description | Default |
|---|---|---|
| Default model | Model for new chats (Opus 4.6 1M, Opus 4.6, Sonnet 4.6, Haiku 4.5) | — |
| Default effort | Reasoning effort level (auto, low, medium, high, max) | Auto |
| Default thinking | Enable extended thinking blocks | Off |
| Show thinking blocks | Display thinking blocks in the chat UI | Off |
| Default plan mode | Start new sessions in plan mode | Off |
| Default fast mode | Start new sessions in fast mode | Off |
See Agent Configuration for detailed descriptions of each option.
Appearance
Section titled “Appearance”| Setting | Description | Default |
|---|---|---|
| Theme | Color theme (12 built-in + custom) | Default Dark |
| Terminal font size | Font size for terminal tabs (8–24px) | 11px |
See Theming for details on built-in themes and creating custom themes.
Notifications
Section titled “Notifications”| Setting | Description | Default |
|---|---|---|
| Notification sound | Sound played when an agent needs input or finishes | Default |
| Notification command | Custom shell command to run on notification | — |
Notification Sound
Section titled “Notification Sound”Choose from built-in sounds or your system’s sound library:
- macOS: System sounds from
/System/Library/Sounds/ - Linux: XDG sound theme sounds
Select None to disable notification sounds.
Notification Command
Section titled “Notification Command”Run a custom shell command when a notification fires. The standard workspace environment variables are available, so your script can identify which workspace triggered the notification.
Example — send a Slack message:
curl -X POST "$SLACK_WEBHOOK_URL" \ -d "{\"text\": \"Claudette: $CLAUDETTE_WORKSPACE_NAME needs attention\"}"| Setting | Description | Default |
|---|---|---|
| Branch prefix mode | How branches are prefixed: username, custom, or none | Username |
| Custom branch prefix | Prefix string when mode is custom | — |
| Auto-delete branch on archive | Delete local branch when archiving a workspace | — |
Branch Prefix Mode
Section titled “Branch Prefix Mode”- Username — prefix with your git username (e.g.,
sean/add-health-check) - Custom — use a custom prefix (e.g.,
feature/,fix/) - None — no prefix, just the descriptive branch name
Auto-Delete on Archive
Section titled “Auto-Delete on Archive”When enabled, archiving a workspace deletes the local branch — but only if the branch contains only checkpoint commits. If you’ve made manual commits on the branch, it will be preserved to prevent data loss.
Repository
Section titled “Repository”Per-repository settings are documented in Per-Repo Settings.
Environment Variables
Section titled “Environment Variables”Claudette sets the following CLAUDETTE_* environment variables in every subprocess it spawns — terminals, setup scripts, the agent CLI, and notification commands.
| Variable | Description | Example |
|---|---|---|
CLAUDETTE_WORKSPACE_NAME | Workspace name | fix-auth-bug |
CLAUDETTE_WORKSPACE_ID | Workspace UUID | a1b2c3d4-... |
CLAUDETTE_WORKSPACE_PATH | Worktree absolute path | /Users/me/.claudette/workspaces/myrepo/fix-auth-bug |
CLAUDETTE_ROOT_PATH | Repository root path | /Users/me/code/myrepo |
CLAUDETTE_DEFAULT_BRANCH | Default branch name | main |
CLAUDETTE_BRANCH_NAME | Workspace branch name | sean/fix-auth-bug |
These are useful in setup scripts, notification commands, and any tools you run in the integrated terminal.