> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://platform.bctrl.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://platform.bctrl.ai/_mcp/server.

# Space Commands

> Create and manage spaces and their mounted environment.

Create and manage spaces and their mounted environment.

Output formatting flags (`--json`, `--jq`, and `--template`) are documented once in [Output Formatting](/cli/output) and are omitted from the tables below.

## `bctrl space list`

List spaces

```bash
bctrl space list [flags]
```

| Flag                   | Description                         |
| ---------------------- | ----------------------------------- |
| `--subaccount <id>`    | Filter by subaccount id             |
| `-L, --limit <number>` | Maximum number of results to return |
| `--cursor <cursor>`    | Pagination cursor                   |

## `bctrl space get`

View a space

```bash
bctrl space get <spaceId>
```

## `bctrl space create`

Create a space

```bash
bctrl space create [flags]
```

| Flag                   | Description   |
| ---------------------- | ------------- |
| `--name <name>`        | Space name    |
| `--subaccount-id <id>` | Subaccount id |

## `bctrl space patch`

Edit a space

```bash
bctrl space patch <spaceId> [flags]
```

| Flag            | Description |
| --------------- | ----------- |
| `--name <name>` | Space name  |

## `bctrl space delete`

Delete a space

```bash
bctrl space delete <spaceId> [flags]
```

| Flag        | Description      |
| ----------- | ---------------- |
| `-y, --yes` | Confirm deletion |