cub unit tree

Display units in a tree view

Synopsis

Display units in a tree view showing relationships between units.

The tree view shows the hierarchical relationships between units based on the specified edge type. Supports two types of relationships:

'clone': Units connected via UpstreamUnit (configuration inheritance)
'link': Units connected via Link relationships (dependency/producer-consumer)

The tree can display either unit names or space names as nodes:

'unit' (default): Shows unit names as tree nodes, with space names in a second column
'space': Shows space names as tree nodes, with unit names in a second column

By default, shows a simple tree structure. When --columns is specified, displays a hybrid tree + tabular view with the tree on the left, complementary info in the second column, and specified columns on the right.

Default columns for hybrid view: Status, UpgradeNeeded, UnappliedChanges, ApplyGates

Examples:

  # Show simple clone tree for all units in current space (clone is default)
  cub unit tree

  # Show link-based tree showing dependency relationships
  cub unit tree --edge link

  # Show tree with space names as nodes
  cub unit tree --node space

  # Show hybrid tree + tabular view with default columns
  cub unit tree --columns

  # Show hybrid view with custom columns for link relationships
  cub unit tree --edge link --columns UnitStatus.Status,UpgradeNeeded,Unit.Labels.Environment

  # Show clone tree for specific units
  cub unit tree --where "Labels.environment = 'production'"

  # Show link tree for specific units
  cub unit tree --edge link --where "Labels.tier = 'web'"

  # Show tree across all spaces (requires --space "*")
  cub unit tree --space "*"

  # Show link tree across all spaces with custom columns
  cub unit tree --edge link --space "*" --columns Space.Slug,UnitStatus.Status

  # Show space-based tree across all spaces
  cub unit tree --node space --space "*" --columns UnitStatus.Status

  # Explicitly specify clone edge type
  cub unit tree --edge clone
 ```

cub unit tree [flags]

### Options

--columns string comma-separated list of columns to display (e.g., Name,TargetID,Labels.Environment,Annotations.Owner) --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 --edge string Edge type for tree relationships (clone, link) (default "clone") --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 tree --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 --node string Node type for tree display (unit, space) (default "unit") --quiet No default output. --resource-type string resource-type filter --select string Comma-separated list of fields to retrieve and display. Entity IDs and Slug are always included. Example: "DisplayName,CreatedAt,Labels" --space string space ID to perform command on --verbose Detailed output, additive with default output --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]+$'" --where-data string where data filter --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 ```

cub unit tree

cub unit tree

Synopsis

SEE ALSO