Superset CLI

The superset command provides fast access to spawning subagents and creating copies of projects in isolated workspaces.

If the CLI is not installed, you can install it using curl -fsSL https://superset.sh/cli/install.sh | sh.

Core Workflow

1. Pick a project and host: superset projects list and superset hosts list.
2. Create a Workspace: superset workspaces create --project <id> --host <id> --name "..." --branch <branch> (or --pr <number>, or --local instead of --host).
3. Spawn an agent: superset agents create --workspace <id> --agent claude --prompt "...".
4. Plan work: superset tasks create --title "..." then tasks update <id-or-slug> as work progresses.

Runtime Context

When invoked from inside a Superset workspace or terminal, these environment variables are set and can provide you with context about your session:

• $SUPERSET_WORKSPACE_ID — current workspace id (use directly with agents create --workspace, automations create --workspace, etc.)
• $SUPERSET_TERMINAL_ID — current terminal session id