Skip to main content
Workspace settings let admins control how the workspace behaves and set defaults that apply to every member. Open settings by clicking the gear icon in the workspace header or navigating to Workspace Settings from the sidebar.

General settings

The General tab controls basic workspace properties.
SettingDescriptionWho can edit
Workspace nameThe display name shown in the dashboard and sidebarAdmin, Owner
Workspace slugThe URL identifier for the workspace (read-only after creation)
Delete workspacePermanently deletes the workspace and all its tasksOwner only
Deleting a workspace is permanent and cannot be undone. All tasks, configuration, and images associated with the workspace will be removed.

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.
OptionBehavior
DisabledTasks run until manually stopped
1 minute to 1 hourTask suspends after the specified idle period
Auto-sleep helps manage compute costs by suspending tasks that aren’t actively being used. Suspended tasks can be resumed instantly.

Member management

The Members tab lets admins control who has access to the workspace and what they can do.

Roles

RoleCapabilities
ViewerView tasks and settings (read-only)
EditorCreate and run tasks, edit personal workspace settings
AdminAll 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:
1

Workspace defaults (lowest priority)

Set by admins in the Workspace Defaults tab. These apply to all members unless overridden.
2

User defaults (middle priority)

Each member’s personal settings from their User Defaults tab. These apply across all workspaces.
3

Workspace user overrides (highest priority)

Per-workspace personal overrides set in the My Workspace Overrides tab. These take top priority.
This hierarchy applies to: AI model, permission mode, environment variables, MCP servers, instructions, initialization scripts, and shell configuration.
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:
SectionDescription
InstructionsCLAUDE.md content appended to agent sessions
Default ModelAI model for new tasks
Permission ModeHow the agent requests approval
Auto-SleepIdle timeout before task suspension
Environment VariablesWorkspace-level secrets and config values
MCP ServersModel Context Protocol server connections
PluginsEnabled plugins from the plugin catalog
Initialization ScriptBash script that runs when a container starts
Shell ConfigurationCustom .bashrc content for container shells
For details on environment variables, see Environment Variables. For custom container images, see Workspace Images.