Workspaces

What is a Workspace

A workspace is your project folder. SoAgents organizes AI conversations by workspace, allowing the AI to read/write files and execute commands within it.

Each workspace runs its own independent backend process (Sidecar).

Adding a Workspace

  1. Click the Workspaces entry in the sidebar
  2. Click Add Workspace
  3. Select a project folder

Switching Workspaces

  • Click a workspace in the sidebar list
  • Or use the workspace selector above the chat input
  • Switching workspaces doesn’t lose your current conversation

Workspace Isolation

Each workspace has:

  • Independent Process — Each workspace runs its own Sidecar
  • Independent Sessions — Sessions are grouped by workspace
  • Shared Config — Providers, MCP, skills are shared globally
  • Project-level Skills — Create workspace-specific skills

Workspace Structure

When you select a workspace, SoAgents creates:

your-project/
├── .claude/
│   ├── skills/          # Project-level skills (global skills auto-synced)
│   └── config.json      # Workspace metadata
└── ...                  # Your project files

File Operations

Within a workspace, the AI can:

  • Read any file contents
  • Create and edit files
  • Execute terminal commands
  • Search files and directories
  • Manage project structure