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.

Note

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