CLI Referenceaerostack workspace

aerostack workspace

Manage MCP workspaces. A workspace is a private collection of skills and MCP servers exposed as a single gateway URL — useful for organizing tools by context (personal, work, per-client).

List workspaces

aerostack workspace list

Output:

  SLUG              NAME                  SKILLS
  personal          Personal              3
* work              Work (active)         7
  client-acme       Acme Corp             2

The * marks the active workspace.


Create a workspace

aerostack workspace create "<name>"
aerostack workspace create "Work Projects"
aerostack workspace create "Client Acme"

Switch active workspace

aerostack workspace use <slug>
aerostack workspace use personal
aerostack workspace use client-acme

All subsequent aerostack skill install commands target the active workspace.


How workspaces work

Each workspace has a unique gateway URL that exposes all its installed skills as MCP tools:

https://gateway.aerostack.dev/ws/<workspace-slug>/sse

Configure this URL in your LLM tool (Claude, Cursor, etc.) to access all skills in that workspace.

Requires aerostack login. Workspaces are per-account — they’re not project-specific.

Workspace + Skills workflow

# 1. Create a workspace for your project
aerostack workspace create "My Project"
 
# 2. Switch to it
aerostack workspace use my-project
 
# 3. Install skills
aerostack skill install johndoe/github-skill
aerostack skill install janedoe/stripe-skill
 
# 4. Use the workspace gateway URL in your LLM tool
# https://gateway.aerostack.dev/ws/my-project/sse