superset

# 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 run --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 run --workspace`, `automations create --workspace`, etc.) - `$SUPERSET_TERMINAL_ID` — current terminal session id If `$SUPERSET_WORKSPACE_ID` is unset, you're not inside a Superset workspace — follow the Core Workflow above to create one. ## Workspaces ```bash superset workspaces create --project <id> --host <id> --name "..." --branch <branch> superset workspaces create --project <id> --local --name "..." --pr <number> superset workspaces list [--host <id> | --local] superset workspaces update <id> --name "..." superset wo...