List Spinup Agents

Run:

spinup agents list

If the CLI already knows your default workspace, Spinup prints the workspace slug and then a compact table:

Workspace: acme
NAME              SLUG             STATUS
Docs Sandbox      docs-sandbox     ready
Browser Research  browser-research provisioning

If there are no agents, the CLI prints:

No agents found.

Choose or override the workspace

Persist the default workspace once:

spinup workspaces use acme

Or override it for one command:

SPINUP_WORKSPACE=acme spinup agents list

API key-only usage

If you already have a personal/device API key, you can skip the stored config:

SPINUP_API_KEY=sk_user_... SPINUP_WORKSPACE=acme spinup agents list

Inspect one agent

Use get when you need one agent's configuration and environment state:

spinup agents get --slug docs-sandbox

See Inspect a Spinup Agent.

Runtime commands

Use runtime commands when you have an agent runtime key and want to check status, execute a prompt, or inspect run history. See Run Spinup Agents.