Skip to main content

​
Settings Hierarchy

Whim uses a four-level settings system. Values at lower (more specific) levels override higher ones: 
Platform defaults          ← built-in Whim defaults
  └─ Team defaults         ← set by team admins
      └─ Workspace defaults ← set by workspace admins
          └─ User defaults   ← set by individual users
LevelWho can editScope
PlatformWhim (built-in)All workspaces, all users
TeamTeam owner / adminAll workspaces in the team
Workspace defaultsTeam adminAll members of the workspace
User defaultsAny memberOnly that user, across workspaces

​
Merge vs. Replace

BehaviorSettings
Merged (values from workspace + user combined)Environment variables, MCP servers, Plugins, Skills
Concatenated (scripts run in sequence)Instructions (CLAUDE.md), Init script, Shell config (.bashrc)
Replaced (lower level wins)Model, Permission mode, Reasoning effort, Auto-sleep, AI provider

​
Source Badges

Each setting displays a badge showing where its current value originates: Using workspace default, Using user default, Using custom, or Not configured. Click Override to create a workspace-specific value, or Clear Override to revert.

​
Opening Settings

Click the gear icon in the sidebar, or use the workspace header menu. The settings modal has four sections: Account, Configuration, Workspace, and Team.

​
Workspace Configuration

Workspace configuration controls the coding environment for every task. Managed in Settings → Configuration → Configurations.
MCP servers extend your agent’s capabilities with external tools and data sources. Two transport types:Stdio — runs as a local process inside the task container:
{
  "name": "my-mcp-server",
  "type": "stdio",
  "command": "npx",
  "args": ["-y", "@example/mcp-server"],
  "env": { "API_KEY": "sk-..." }
}
HTTP — runs externally, accessed over HTTPS:
{
  "name": "remote-server",
  "type": "http",
  "url": "https://mcp.example.com/sse"
}
MCP servers use merge semantics. Servers from workspace and user levels are combined; same-name conflicts are resolved by source ordering.
Custom slash commands that the agent can invoke during a task (e.g., /deploy, /lint). Defined at workspace and user levels with merge semantics. See Skills & Slash Commands for details.
Injected into every task container. Managed as env files — named groups of key-value pairs.
  • Secret detection — keys containing KEY, SECRET, TOKEN, PASSWORD are auto-masked in the UI.
  • Merge semantics — workspace and user env vars are merged. Source ordering controls priority.
  • Multiple env files let you organize by concern (e.g., api-keys, database, feature-flags).
Pre-built integrations from the Claude marketplace. Toggled per workspace and per provider. Plugins use merge semantics. See Plugins for details.
Plugins are available for Claude and CCR. Not currently supported for Codex.
Three types of scripts run at different points:
  • Instructions (CLAUDE.md) — Markdown injected into the agent’s system prompt. Concatenated from workspace + user levels.
  • Initialization script (init.sh) — bash script that runs once when the container starts, before the agent begins. Concatenated from multiple levels.
  • Shell configuration (.bashrc) — loaded into each terminal session. Concatenated from multiple levels.
Suspends idle task containers to conserve CUs. Options: Disabled, 1min, 5min, 10min, 15min (default), 30min, 1hr. The most specific level wins.

​
Provider Defaults

Configured per AI provider (Claude, Codex, CCR) in Settings → Configuration → Providers.
Select the default AI model for tasks. Available models depend on the provider:
  • Claude — Claude model variants (Sonnet, Opus, etc.)
  • Codex — GPT model variants
  • CCR — models via OpenRouter

​
AI Provider Selection

Your default AI provider is a user-level setting:
ProviderRuntimeDescription
ClaudeClaude Code CLIAnthropic’s native coding agent
CodexCodex CLIOpenAI’s native coding agent
CCRClaude Code RunnerClaude models via OpenRouter API keys

​
User Preferences

Personal settings in the Account section that follow you across all workspaces.
  • Name — displayed to teammates in comments, assignments, and member lists. Auto-saves on blur.
  • Email — pulled from GitHub OAuth. Read-only.
  • GitHub Username — set during sign-up. Read-only in Whim.
  • Avatar — upload a custom photo (JPG, PNG, WebP, GIF, max 5 MB) with built-in cropping. Falls back to your GitHub avatar.
Light or Dark mode. Saved locally in your browser. Defaults to dark.
Browser notifications for events when Whim isn’t in focus. Grant browser permission first, then toggle types:
TypeFires when…
Claude waiting for inputAgent finishes and awaits your response
Comments on my tasksSomeone comments on your task
When I’m @mentionedSomeone mentions you with @username
Reactions to my commentsSomeone reacts to your comment
Master toggle must be on for any individual notification to fire.
Panel visibility (left sidebar, right detail panel) is saved per browser and restored on return.
Personal env vars applied across all workspaces. Merged with workspace-level vars. Common uses: personal API keys, tool config (EDITOR=vim), feature flags.
Env vars with secrets are masked in the UI but available in plaintext inside containers. Don’t share workspace access with untrusted users if your vars contain sensitive credentials.

​
Keyboard Shortcuts

On macOS use Cmd; on Windows/Linux use Ctrl.
ShortcutAction
Cmd + EnterSubmit prompt — create task or todo
TabToggle between Task and Todo mode
ShortcutAction
Cmd + .Toggle read mode (terminal ↔ conversation reader)
Cmd + EnterLaunch a todo
Cmd + AToggle assignee dropdown
EscapeClose dropdown or blur editor
ShortcutAction
Cmd + FOpen find bar
EscapeClose find bar
Cmd + G / F3Next match
Cmd + Shift + G / Shift + F3Previous match
ShortcutAction
Ctrl + CInterrupt process
Ctrl + ZSuspend foreground process
Ctrl + LClear screen
Ctrl + DSend EOF
Up / DownNavigate command history
TabAuto-complete
ShortcutAction
Cmd + EnterSubmit comment
Shift + EnterSave config field
  • Swipe left on a task for quick actions (complete, archive, restore, delete).
  • When the terminal is active, a virtual key toolbar appears with Esc, Tab, arrow keys, Paste, Attach, and Enter.