Skip to content

cub space list

cub space list

List spaces

Synopsis

List spaces you have access to in this organization. The output includes slugs, environment labels, and summary counts for units, workers, targets, and triggers.

Examples:

  # List all spaces with headers
  cub space list

  # List spaces without headers for scripting
  cub space list --no-header

  # List spaces in JSON format
  cub space list --json

  # List spaces with custom JQ filter
  cub space list --jq '.[].Slug'

  # List spaces matching a specific criteria
  cub space list --where "Labels.Environment = 'prod'"
 ```
cub space list [flags]
### Options
--contains string Free text search for entities containing the specified text. Searches across string fields (like Slug, DisplayName) and map fields (like Labels, Annotations). Case-insensitive matching. Can be combined with --where using AND logic. Example: "backend" to find entities with backend in any searchable field --filter string Filter entity to apply to the list. Specify as 'space/filter' for cross-space filters or just 'filter' for current space. Supports both slugs and UUIDs. The filter will be combined with any --where clause using AND logic. Examples: "production-filters/security-check", "my-filter-uuid", "validation-rules" -h, --help help for list --jq string jq expression, suppressing default output --json JSON output, suppressing default output --names Only output names, suppressing default output --no-header No header for lists --quiet No default output. --select string Comma-separated list of fields to retrieve and display. Entity IDs and Slug are always included. Example: "DisplayName,CreatedAt,Labels" --verbose Detailed output, additive with default output --web Open in web UI instead of executing --where string Filter expression using SQL-inspired syntax. Supports conjunctions with AND. String operators: =, !=, <, >, <=, >=, LIKE, ILIKE, ~~, !~~, ~, ~, !~, !~. Pattern matching with LIKE/ILIKE uses % and _ wildcards. Regex operators (~, ~, !~, !~) support POSIX regular expressions. Examples: "Slug LIKE 'app-%'", "DisplayName ILIKE '%backend%'", "Slug ~ '^[a-z]+-[0-9]+$'" --yaml YAML output, suppressing default output --yq string yq expression, suppressing default output
### Options inherited from parent commands
--context string The context to use for this command --debug Debug output ```

SEE ALSO