Workspaces

Use workspaces list to inspect the workspaces visible to the current CLI token:

spinup workspaces list

Example output:

Default workspace: bravo (config)
CURRENT  NAME   SLUG
         Acme   acme
*        Bravo  bravo

Use workspaces use to persist the default workspace the CLI should use for workspace-scoped commands:

spinup workspaces use bravo

That updates defaultWorkspaceSlug in ~/.config/spinup/config.json and removes any need to depend on dashboard state for normal multi-workspace CLI usage.

One-off override

If you only want to override the workspace for a single command, use SPINUP_WORKSPACE:

SPINUP_WORKSPACE=acme spinup agents list

Environment variables still win over the stored config, so SPINUP_WORKSPACE overrides a previously selected default until you unset it.

JSON output

Both commands support --json:

spinup workspaces list --json
spinup workspaces use bravo --json

Non-default API hosts

If the command would send credentials to a non-default API host, add --allow-non-default-host:

spinup workspaces list --allow-non-default-host