# aerostack workspace

> Create and manage MCP workspaces from the CLI. A workspace groups skills and MCP servers behind a single gateway URL.

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

```bash
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

```bash
aerostack workspace create "<name>"
```

```bash
aerostack workspace create "Work Projects"
aerostack workspace create "Client Acme"
```

---

## Switch active workspace

```bash
aerostack workspace use <slug>
```

```bash
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

```bash
# 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

# https://gateway.aerostack.dev/ws/my-project/sse
```