Skip to main content
For the complete documentation index optimized for AI agents, see llms.txt.
Manage the active Helix Cloud workspace selection stored in ~/.helix/config.

Usage

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-commandDescription
listList workspaces you can access.
showShow the currently selected workspace.
switch <WORKSPACE>Select a workspace by slug or ID.

helix workspace list

FlagTypeDescriptionDefault
--formathuman | jsonOutput format.human

helix workspace show

FlagTypeDescriptionDefault
--formathuman | jsonOutput format.human

helix workspace switch

ArgumentDescription
WORKSPACEWorkspace slug or ID.
FlagTypeDescription
--idBooleanTreat WORKSPACE as an ID rather than a slug.

Examples

# 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
helix workspace requires Helix Cloud authentication. Run helix auth login first.