CH·02CLI reference

gpu instances list

List your GPU instances

List your GPU instances

Synopsis

Lists GPU instances visible to the authenticated org. By default only non-terminated instances are shown — the live fleet, not the full provision history. Use --status terminated for the history, --status to filter by a specific state, or --all for everything. Output is paginated up to --limit rows (default 50, max 200). On TTY the result is a tabwriter-aligned table; off-TTY it defaults to JSON.

gpu instances list [flags]

Examples

# Table view (default on TTY)
gpu instances list

# JSON for jq pipelines
gpu instances list --output json | jq '.[] | {id, status}'

# Limit results
gpu instances list --limit 10

# Only running instances
gpu instances list --status running

# Full history including terminated instances
gpu instances list --all

Options

      --all             Include terminated instances (shorthand for --status=all)
  -h, --help            help for list
      --limit int       Max instances to fetch (1-200) (default 50)
      --status string   Filter by status: starting | running | stopping | stopped | terminated | error | all (default: all non-terminated)

Options inherited from parent commands

      --api-base string   API base URL (override with GPUAI_API_BASE env) (default "https://api.gpu.ai/v1")
      --debug             Enable debug logging to stderr
  -o, --output string     Output format: table|json (default table on TTY, json otherwise)

SEE ALSO

← The gpu CLI