General settings
The General tab controls basic workspace properties.| Setting | Description | Who can edit |
|---|---|---|
| Workspace name | The display name shown in the dashboard and sidebar | Admin, Owner |
| Workspace slug | The URL identifier for the workspace (read-only after creation) | — |
| Delete workspace | Permanently deletes the workspace and all its tasks | Owner only |
Default AI provider and model
Workspace admins can set a default AI provider and model that applies to all tasks in the workspace. Members can override these defaults in their personal workspace settings.- Default model — Select from available models (e.g., Claude Sonnet, Claude Opus). This becomes the default for new tasks unless a member has set their own override.
- Default permission mode — Controls how the AI agent requests approval for actions:
- Use user preference — Each member’s personal setting applies
- Default — Standard permission prompts
- Accept Edits — Auto-approve file edits, prompt for other actions
- Plan Mode — Agent creates plans without executing
- Bypass Permissions — Auto-approve all actions
Workspace instructions (CLAUDE.md)
Add custom instructions that get appended to every AI agent session in the workspace. Use this for project-specific conventions, coding standards, or context that every task should know about. These instructions are combined with each member’s personal instructions — workspace instructions don’t replace personal ones, they augment them.Auto-sleep
Configure how long a task can be idle before Whim automatically suspends it to save resources.| Option | Behavior |
|---|---|
| Disabled | Tasks run until manually stopped |
| 1 minute to 1 hour | Task suspends after the specified idle period |
Member management
The Members tab lets admins control who has access to the workspace and what they can do.Roles
| Role | Capabilities |
|---|---|
| Viewer | View tasks and settings (read-only) |
| Editor | Create and run tasks, edit personal workspace settings |
| Admin | All editor capabilities plus: manage members, edit workspace defaults, manage images |
Managing members
- Add members — Click Add Member to invite team members to the workspace. Only existing team members can be added.
- Change roles — Admins can change any member’s role using the role dropdown next to their name.
- Remove members — Admins can remove members from the workspace. You cannot remove yourself.
Workspace defaults vs. personal overrides
Workspace settings follow a three-level hierarchy. Each level can override the one below it:Workspace defaults (lowest priority)
Set by admins in the Workspace Defaults tab. These apply to all members unless overridden.
User defaults (middle priority)
Each member’s personal settings from their User Defaults tab. These apply across all workspaces.
Members can save their workspace overrides as new user defaults using the Save to user defaults button, which copies the current workspace-specific settings into their global personal settings.
Configuration sections
The workspace defaults tab includes these configurable sections:| Section | Description |
|---|---|
| Instructions | CLAUDE.md content appended to agent sessions |
| Default Model | AI model for new tasks |
| Permission Mode | How the agent requests approval |
| Auto-Sleep | Idle timeout before task suspension |
| Environment Variables | Workspace-level secrets and config values |
| MCP Servers | Model Context Protocol server connections |
| Plugins | Enabled plugins from the plugin catalog |
| Initialization Script | Bash script that runs when a container starts |
| Shell Configuration | Custom .bashrc content for container shells |

