Skip to content

Workspaces

A workspace is a directory that holds multiple repositories. Each user has their own isolated workspaces — no two users share the same session directory.

Every user starts with a default workspace created automatically on first use.

Listing workspaces

/workspace

Shows all workspaces with a checkmark next to the currently active one.

Switching workspaces

Click any workspace name in the /workspace list to switch to it. Switching workspaces ends any active session.

Creating a new workspace

/workspace new <name>

Names must be 32 characters or fewer and contain only letters, numbers, -, and _.

Example:

/workspace new client-projects

How workspaces are stored

Each workspace is a subdirectory under the user’s session folder:

sessions/<chat_id>/
default/
client-projects/
experiment/

Inside each workspace are cloned repositories, not bare repo directories.

Use cases

  • Separate clients — keep each client’s code in its own workspace
  • Experiments — try out repos in a separate workspace without cluttering your main one
  • Project categories — group repos by language, team, or ownership