> ## Documentation Index
> Fetch the complete documentation index at: https://helix-isolate-failing-index-entities.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# helix workspace

> Discover WorkOS workspace memberships

<div className="flex flex-wrap gap-2"><Badge color="gray" size="sm">Reference</Badge></div>

List and inspect the Helix Cloud workspaces your login can access. Cloud only; these commands are
read-only.

## Usage

```bash theme={null}
helix workspace [list]
helix workspace get [WORKSPACE]
```

## Subcommands

| Subcommand | Description |
| - | - |
| `list` | List every workspace you are a member of. The default when no subcommand is given. |
| `get` | Show one workspace. |

## Arguments

| Argument | Description |
| - | - |
| `WORKSPACE` | `get`: workspace ID, slug, or name. Defaults to the linked workspace, then the only workspace. |

## Options

| Flag | Description | Default |
| - | - | - |
| `--json` | Print the result as JSON on stdout and never prompt. | Off |

## Behavior

* The WorkOS session hydrates all current memberships. `list` marks the workspace linked in `helix.toml`.
* There is no `workspace switch` command and no persisted active workspace.
* Commands that need a workspace take `--workspace <id|slug|name>`, or resolve one as described in [Cloud resource resolution](/cli/command-reference#cloud-resource-resolution).

## Examples

```bash theme={null}
# List your workspaces
helix workspace

# Show one workspace as JSON
helix workspace get <workspace> --json
```

## Related

* [`helix auth`](/cli/command-reference/auth) — log in before listing workspaces.
* [`helix project`](/cli/command-reference/project) — list projects in a workspace.
* [Helix Cloud workflow](/cli/workflows/helix_cloud) — end-to-end Cloud usage.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.