Workspaces

Workspace commands control the organization context for CLI operations.

Most CLI commands operate in either personal space or the selected workspace. Make workspace selection explicit in scripts so private data and credit usage go where you expect.

Select a workspace

epismo workspace list
epismo workspace current
epismo workspace use $WORKSPACE_ID
epismo workspace clear

workspace clear returns the CLI to personal space. When EPISMO_TOKEN is set, the token's embedded workspace is used and the saved default is ignored.

Use epismo workspace current in automation before running destructive or costly commands. It prints the effective workspace context as JSON.

Create and update workspaces

epismo workspace create --name "Team" --plan basic
epismo workspace update $WORKSPACE_ID --name "New name"
epismo workspace checkout $WORKSPACE_ID

Plans are basic or pro. workspace checkout returns the billing URL for completing or retrying workspace payment.

Workspace names must be valid subdomain-style names: 3 to 30 characters, lowercase letters, numbers, and hyphens only. Reserved names are rejected.

workspace checkout prints a billing URL. Complete payment in the browser before assuming the plan change is active.

Workspace members

epismo workspace member list
epismo workspace member upsert $USER_ID --role admin
epismo workspace member upsert $USER_ID_1,$USER_ID_2 --role member
epismo workspace member delete $USER_ID
epismo workspace member delete $USER_ID_1,$USER_ID_2

Roles are owner, admin, and member. Both workspace member upsert and workspace member delete accept a single user ID or a comma-separated list of user IDs.

Workspace membership is not the same as project access. Add users to the relevant projects before expecting them to see project-scoped packs or tracks.