Settings

Clutch stores all settings in SQLite. Each settings page is accessible from the sidebar or via the settings icon in the chat header.

General

The General tab covers appearance and personalization.

Theme — Choose from Clutch (signature indigo theme), Nord, Dracula, Cyberpunk, Catppuccin, GitHub, Tokyo Night, or Monokai. Each theme includes light and dark variants. Smooth transitions between modes.
Language — Select your preferred language. English, Danish, German, Polish, and French are available out of the box. Language preference persists across sessions.
Display Name — Set a custom display name shown in the chat sidebar and message headers.
Avatar — Choose from uploaded images, emoji, initials, or the default UserCircle icon. Avatar color is customizable.
Time Format — Auto-detect (12h or 24h based on system locale), force 12-hour, or force 24-hour display for message timestamps.
Developer Mode — Toggle to enable the built-in log viewer and additional debugging tools.

Configure your LLM provider connections.

API Keys — Enter your API key for each provider (DeepSeek, OpenCode Go, OpenCode Zen). Keys are stored in SQLite and displayed as password fields. Keys are never sent to the frontend after initial save; only masked views (sk-...****) are shown.
Test Connection — Each provider has a "Test" button that sends a lightweight API call to verify your key works. A pulsing indicator shows connection status.
Default Model — Select the default model for each provider from a dynamically loaded dropdown. Model lists are fetched from provider APIs and cached for 24 hours.
Enable/Disable — Toggle individual providers on or off. Disabled providers are hidden from the model selector in chat.

Control how Clutch behaves when your system starts.

Run on System Startup — Automatically launch Clutch when you log in. Uses LaunchAgents on macOS, Registry on Windows, and autostart on Linux.
Start Minimized — Launch Clutch minimized to the system tray without opening the main window.
Close to Tray — When enabled, clicking the close button hides Clutch to the tray instead of quitting.

Configure global keyboard shortcuts that work system-wide when Clutch is running.

Show Main — Default: CmdOrCtrl + Ctrl + K (macOS) / CmdOrCtrl + Alt + K (Windows/Linux). Shows and focuses the main Clutch window.
Customization — All shortcuts can be remapped in Settings. Reserved system keys (Cmd+W, Cmd+Q, etc.) are blocked to prevent conflicts.

Manage local project folders for file-aware conversations.

Add Workspace — Select a project folder via the native OS directory picker. Clutch detects project indicators like package.json, Cargo.toml, and .git.
Active Workspace — One workspace is active at a time. The active workspace is used for @ mentions, file reading, and skill execution.
Auto-Detection — Clutch scans common dev directories (Projects, Code, Dev, workspace) and suggests them as workspace candidates.
Remove — Remove workspaces you no longer need. File access is scoped to selected directories only.

Set your preferred export behavior.

Default Format — Choose between Markdown, Plain Text, JSON, or HTML. Markdown is the recommended format for portability.
Include Metadata — Toggle whether exports include provider name, model, creation date, update date, and token counts.
Include Timestamps — Add per-message timestamps to exports using your configured time format.
Include Provider Info — Append provider and model information to each exported message.
Include System Prompt — Optionally include the system prompt in exports (useful for sharing prompt engineering setups).