Workspaces

Workspaces organize your agents, configurations, and resources.

What is a Workspace?

A workspace is a container for:

• Agents: Your AI agents
• Configurations: Settings and parameters
• Memory: Agent context and data
• Tools: Custom functions
• Secrets: API keys and credentials

Creating Workspaces

Via CLI

# Create workspace
swiftclaw workspaces create my-workspace

# Set as default
swiftclaw workspaces use my-workspace

Via Dashboard

1. Click "New Workspace"
2. Enter workspace name
3. Configure settings
4. Click "Create"

Workspace Structure

my-workspace/
├── agents/
│   ├── customer-support/
│   └── data-processor/
├── config/
│   ├── models.json
│   └── tools.json
├── memory/
│   └── persistent/
└── secrets/
    └── .env

Workspace Isolation

Workspaces are isolated:

• Separate Resources: Independent compute and storage
• Isolated Memory: No cross-workspace data access
• Independent Billing: Separate usage tracking
• Access Control: Per-workspace permissions

Switching Workspaces

# List workspaces
swiftclaw workspaces list

# Switch workspace
swiftclaw workspaces use production-workspace

# View current workspace
swiftclaw workspaces current

Workspace Settings

Default Model

swiftclaw config set default-model gpt-4

Memory Configuration

swiftclaw config set memory-ttl 30d

Tool Registry

swiftclaw tools register my-custom-tool

Team Workspaces

Invite Members

swiftclaw workspaces invite user@example.com \
  --role developer

Roles

• Owner: Full access
• Admin: Manage settings and members
• Developer: Create and deploy agents
• Viewer: Read-only access

Workspace Limits

Next Steps

• Environments
• Agents
• Configuration