Workspaces

A workspace is a container for your team's skills, instructions, and members. You can create multiple workspaces for different teams, projects, or clients.

Star a workspace from the workspaces list to pin your favorites to the top — handy once you belong to more than a few.

Creating a Workspace

Navigate to Workspaces in the sidebar
Click Create Workspace
Enter a workspace name
Add an optional description
Choose whether to enable Session Files
Click Create

Your workspace will be created with a unique slug (e.g., my-workspace-a1b2c3).

Workspace Overview

The workspace overview shows key information at a glance:

Statistics — Agents, Teams, Members, and monthly Usage
Usage Chart — Daily request activity graph
Quick Actions — Create skills, manage members
Recent Activity — Latest changes in the workspace

Workspace Settings

Access workspace settings to:

Edit workspace name and description
Update the workspace slug (warning: affects SuperClawd connections)
Enable/disable session files
Enable/disable the response cache (owner only — see below)
View workspace ID and creation date
Leave or delete the workspace

Response cache (save credits)

The workspace response cache is on by default. The first time something in the workspace is fetched that costs credits — a skill's instructions, a command, a resource, or a workflow — the result is cached for a few minutes. An identical fetch within that window is served from the cache for free: no credits are charged the second time. A workspace owner can turn it off.

On by default — an owner can turn it off if they'd rather every fetch be charged.
Shared across the whole workspace, not per member.
Always fresh. Editing or releasing a skill, command, resource, or workflow clears the cache immediately, so you never get stale content — the next fetch is charged and re-cached.

Changing the workspace slug

Updating the workspace slug will break existing SuperClawd connections. All team members will need to re-select the workspace in the startup picker — press d to set it as the new default. Stale defaults self-heal automatically: if a saved default is no longer reachable, the CLI clears it and re-shows the picker.

Your Default Workspace

Your credentials work across every workspace you belong to, so you can change your default anytime — no reconfiguring. Running superclawd shows a workspace picker: use ↑/↓ to highlight a workspace, press Enter to launch into it for that session, or press d to mark it as your default (★). Future launches boot straight into your default.

The picker appears at every startup by default, so you can pick a workspace for the session while your default stays put. Prefer to boot silently into your default instead? Turn Choose workspace at startup off via superclawd config. Defaults also self-heal: if your saved default is a workspace you can no longer access, the CLI clears it and re-shows the picker automatically.

Activity Tracking

Every action in a workspace is logged for transparency and auditing:

Skill Changes — Created, updated, or deleted skills
Instruction Changes — Added, modified, or removed instructions
Member Activity — Joins, role changes, and departures
Settings Updates — Workspace configuration changes

View the activity log in the Activity tab of your workspace to see:

What changed
Who made the change
When it happened
Before/after values (where applicable)

Leaving a Workspace

Any member (except the owner) can leave a workspace:

Go to Workspace Settings
Scroll to Danger Zone
Click Leave Workspace
Confirm your decision

Deleting a Workspace

Only workspace owners can delete a workspace:

Go to Workspace Settings
Scroll to Danger Zone
Click Delete Workspace
Type the workspace name to confirm
Click Delete

This action is irreversible

Deleting a workspace removes all skills, instructions, and member associations permanently.