> ## Documentation Index
> Fetch the complete documentation index at: https://docs.helix-db.com/llms.txt
> Use this file to discover all available pages before exploring further.

# helix workspace

> For the complete documentation index optimized for AI agents, see [llms.txt](/llms.txt).

Manage the active Helix Cloud workspace selection stored in `~/.helix/config`.

## Usage

```bash theme={"languages":{"custom":["languages/helixql.json"]}}
helix workspace <SUBCOMMAND>
```

If you run `helix workspace` with no subcommand in a TTY, the CLI prompts you to choose a workspace.

## Available sub-commands

| Sub-command          | Description                            |
| -------------------- | -------------------------------------- |
| `list`               | List workspaces you can access.        |
| `show`               | Show the currently selected workspace. |
| `switch <WORKSPACE>` | Select a workspace by slug or ID.      |

### `helix workspace list`

| Flag       | Type              | Description    | Default |
| ---------- | ----------------- | -------------- | ------- |
| `--format` | `human` \| `json` | Output format. | `human` |

### `helix workspace show`

| Flag       | Type              | Description    | Default |
| ---------- | ----------------- | -------------- | ------- |
| `--format` | `human` \| `json` | Output format. | `human` |

### `helix workspace switch`

| Argument    | Description           |
| ----------- | --------------------- |
| `WORKSPACE` | Workspace slug or ID. |

| Flag   | Type    | Description                                    |
| ------ | ------- | ---------------------------------------------- |
| `--id` | Boolean | Treat `WORKSPACE` as an ID rather than a slug. |

## Examples

```bash theme={"languages":{"custom":["languages/helixql.json"]}}
# List accessible workspaces
helix workspace list

# Show the active workspace
helix workspace show

# Switch by slug
helix workspace switch my-team

# Switch by ID
helix workspace switch ws_01HX... --id
```

<Note>
  `helix workspace` requires Helix Cloud authentication. Run `helix auth login` first.
</Note>

## Related

* [`helix project`](/cli/command-reference/project) — link the local project to a workspace project
* [`helix cluster`](/cli/command-reference/cluster) — list Helix Cloud clusters
* [`helix auth`](/cli/command-reference/auth) — authenticate with Helix Cloud