GoodMem
ReferenceCLI

Space List

Space List CLI command reference

goodmem space list

List spaces

Synopsis

List spaces in the GoodMem service with filtering, sorting, and pagination.

goodmem space list [flags]

Examples

  # List all spaces with default settings
  goodmem space list

  # Filter spaces by labels
  goodmem space list --label project=demo --label env=test

  # Filter spaces by name pattern (glob-style)
  goodmem space list --name "Project*"

  # Filter spaces by owner
  goodmem space list --owner 123e4567-e89b-12d3-a456-426614174000

  # Sort spaces by name in ascending order (shows a sort indicator in the header)
  goodmem space list --sort-by name --sort-order asc

  # Paginate results (default page size is 50)
  goodmem space list --max-results 10

  # Get the next page of results using the token from previous output
  goodmem space list --next-token "eyJzdGFydCI6MTAsIm..."

  # Get output in different formats
  goodmem space list --format json     # Detailed JSON output
  goodmem space list --format table    # Tabular output with headers (default)
  goodmem space list --format compact  # Compact single-line format

  # Get only space IDs (for scripting)
  goodmem space list --quiet

Options

  -f, --format string       Output format (json, table, or compact) (default "table")
  -h, --help                help for list
  -l, --label strings       Filter spaces by label in key=value format (can be specified multiple times)
      --max-results int32   Maximum number of results per page
  -n, --name string         Filter spaces by name pattern with glob-style matching (e.g., "Project*")
      --next-token string   Token for fetching the next page of results
      --no-trunc            Do not truncate output values
  -o, --owner string        Filter spaces by owner ID (UUID)
  -q, --quiet               Output only space IDs
      --sort-by string      Sort spaces by field (name, created_at, updated_at)
      --sort-order string   Sort order (asc or desc)

Options inherited from parent commands

      --api-key string   API key for authentication (can also be set via GOODMEM_API_KEY environment variable)
      --server string    GoodMem server address (gRPC API) (default "https://localhost:9090")

SEE ALSO