show units
Shows units for a framework (build|test|lint|scan) with cache status visualization.
The report includes:
- Summary statistics (total, cached, stale, new, container, host)
- Cache status overview with percentages
- Units grouped by module with status icons
- Stale units section for quick identification
Filter Examples: show units build # All build units show units test --module eac # Test units for specific module show units lint --stale # Only stale lint units show units scan --container # Only container-based scan units
Usage: show units [flags]
| Flag | Description |
|---|---|
--module <string> (optional) |
Filter to specific module |
--component <string> (optional) |
Filter to specific component |
--cached (optional, default: false) |
Only show cached (up-to-date) units |
--stale (optional, default: false) |
Only show stale units |
--container (optional, default: false) |
Only show container-based units |
--host (optional, default: false) |
Only show host-installed units |
Output Sections
The report includes:
- Summary - Statistics table with total units, cached/stale/new counts, and container vs host counts.
- Cache Status Overview - Breakdown of cached, stale, and new units with percentages.
- Units by Module - Units grouped by module, with columns: Status (icon), Component, Tool, Weight, Type (host/container), Last Run (relative time), Reason (why stale).
- Stale Units - Dedicated section listing only units that need execution, with their staleness reasons. Only shown if stale units exist.
- Dependency Chain - Intra-module dependencies between units. Only shown if dependencies exist.
See Also
- get units - Structured data output
- show components - Component-level view
Tutorials | How-to Guides | Explanation | Reference
You are here: Reference — information-oriented technical descriptions of the system.