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-headers

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

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

  # List spaces matching a specific criteria
  cub space list --where "Labels.Environment = 'prod'"
 ```
cub space list [flags]
### Options
--columns strings columns to display; can be repeated or comma-separated (e.g., Slug,Labels.Environment) --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 --no-headers Don't print headers for table output -o, --output string Output format. One of: json, yaml, name, wide, mutations, jq=, yq=, custom-columns= --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, NOT 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]+$'"
### Options inherited from parent commands
--context string The context to use for this command --debug Debug output ```

SEE ALSO