Workspaces

What is a Workspace?

A workspace is an isolated context for a specific project, client, or role. Conversations created in a workspace stay there, and its configuration doesn't leak into others.

Common use cases:

• Work vs. Personal — Keep work conversations, sources, and API keys completely separate from personal projects.
• Per-client — Agencies and consultants can have one workspace per client with client-specific sources and skills.
• Per-project — Different tech stacks, different code repos, different skills.
• Role-based — "Engineering" workspace with code tools, "Marketing" workspace with content skills.

Creating a Workspace

1. 1.Click the workspace switcher at the top of the sidebar (shows the current workspace name).
2. 2.Select New Workspace.
3. 3.Give it a name, choose an icon, and optionally duplicate an existing workspace's configuration as a starting point.
4. 4.Configure sources, skills, and statuses for the new workspace in its settings.

Workspace Configuration

Each workspace stores its configuration at:

~/.agently/workspaces/<workspace-id>/
├── config.json        # Workspace settings
├── skills/            # Workspace-specific SKILL.md files
└── sources.json       # Source configurations

The config.json for a workspace:

{
  "name": "My Project",
  "icon": "🚀",
  "defaultModel": "claude-3-5-sonnet-20241022",
  "defaultProvider": "anthropic",
  "defaultPermission": "ask-to-edit",
  "theme": {
    "accent": "#7C3AED",
    "darkMode": true
  },
  "statuses": [
    { "id": "backlog", "name": "Backlog", "color": "#6B7280", "open": true },
    { "id": "active", "name": "Active", "color": "#3B82F6", "open": true },
    { "id": "shipped", "name": "Shipped", "color": "#10B981", "open": false }
  ]
}

Switching Workspaces

Use the workspace switcher in the top-left of the sidebar, or press ⌘1 – ⌘9 to switch to workspaces 1–9 in the order they appear.

Switching workspaces changes the conversation list, sidebar label list, and all workspace- specific settings instantly. Open conversations in a previous workspace remain open — switch back to resume them.

Global vs Workspace Resources