Skip to content

cub component list

cub component list

List components

Synopsis

List the components in this organization, with their owner, their variants, and the number of spaces and units they span.

Components are derived from the "Component" label on spaces, so --where filters spaces, not components: a component is listed if any of its spaces match.

Examples: 

  # List all components
  cub component list

  # List just the component names
  cub component list -o name

  # List components owned by a team
  cub component list --where "Labels.Owner = 'platform'"

  # List components that have a prod variant
  cub component list --where "Labels.Variant = 'prod'"

cub component 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=<expr>, yq=<expr>, custom-columns=<spec>
      --quiet             No default output.
      --verbose           Detailed output, additive with default output
      --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