cub space list

List spaces

Synopsis

List spaces you have access to in this organization. The output includes slugs, the standard space labels, and the number of units. Use --output=wide to also show the counts of links, tags, changesets, filters, views, invocations, triggers, workers, targets, and attributes.

Examples:

  # List all spaces with headers
  cub space list

  # List spaces with all summary counts
  cub space list --output=wide

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

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

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

  # List spaces matching a specific criteria
  cub space list --where "Labels.Environment = 'prod'"

  # List the spaces that are Variants of a Component
  cub space list --component my-app

  # List a Component's production spaces in one region
  cub space list --component my-app --environment prod --region us-east1
 ```

cub space list [flags]

### Options

--columns strings columns to display; can be repeated or comma-separated (e.g., Slug,Labels.Environment) --component string only list Spaces that are Variants of the Component with this slug; ANDed with --where --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 --environment string only list Spaces whose "Environment" label has this value (e.g. Prod); ANDed with --where --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 --include-hidden string[=""] Also select hidden entities, to list or to act on: those hidden for the given HiddenReasons, comma-separated, as in --include-hidden=BackingUnit, or for any reason when given no value or "". ConfigHub/YAML Units, which hold the configuration of other entities, are hidden with the reason BackingUnit. A --where naming entities by Slug or ID selects them whether hidden or not --layer string only list Spaces whose "Layer" label has this value (e.g. App); ANDed with --where --limit int Return at most this many entities; 0 returns all of them. They are read from the server in pages of at most 1000 --no-headers Don't print headers for table output --order-by string Order the entities by these fields, as comma-separated 'ASC:Field', 'DESC:Field' or 'Field' terms, such as "DESC:CreatedAt". Entities with equal values are ordered by ID. With --limit, this decides which entities are returned -o, --output string Output format. One of: json, yaml, name, wide, mutations, jq=, yq=, custom-columns= --owner string only list Spaces whose "Owner" label has this value (e.g. Engineering); ANDed with --where --quiet No default output. --region string only list Spaces whose "Region" label has this value (e.g. us-east1); ANDed with --where --select string Comma-separated list of fields to retrieve and display. Entity IDs and Slug are always included. Example: "DisplayName,CreatedAt,Labels" --stage string only list Spaces whose "Stage" label has this value (e.g. Canary); ANDed with --where --variant string only list Spaces whose "Variant" label has this value (e.g. prod); ANDed with --where --verbose Detailed output, additive with default output --view string View, by slug or UUID, whose columns to display. The View's Filter, if it has one, selects the entities as --filter does --where string Filter expression using SQL-inspired syntax. Supports conjunctions with AND. String operators: =, !=, <, >, <=, >=, LIKE, NOT LIKE, ILIKE, ~~, !~~, ~, ~, !~, !~. Pattern matching with LIKE/ILIKE uses % and _ wildcards. Regex operators (~, ~, !~, !~) support POSIX regular expressions. A related entity is referenced by prefix, as in "UpstreamUnit.Slug = 'base'"; when the reference names a list, a * segment matches any element, as in "FromLink.*.Slug = 'upgrade-app'". Examples: "Slug LIKE 'app-%'", "DisplayName ILIKE '%backend%'", "Slug ~ '^[a-z]+-[0-9]+$'"

### Options inherited from parent commands

--context string The context to use for this command --debug Debug output ```

cub space list

cub space list

Synopsis

SEE ALSO