oc aibom list¶
Lists AIBOMs with the fields you'd otherwise have to dig for in -o yaml: job, model, experiment intent, quantization, GPU type, and collection time.
oc aibom list -n my-namespace
oc aibom list -A # all namespaces
oc aibom list --model=granite-3.0-8b # filter by model.name
oc aibom list --intent=sft # training | sft | inference
oc aibom list --quantization=int4
oc aibom list --architecture=llama # filter by model.architecture
oc aibom list --framework=vllm # filter by model.framework
oc aibom list --gpu-type=A100 # filter by environment.gpu_type
oc aibom list --job=my-training-job # filter by job name
oc aibom list --git-branch=main # filter by source_code.git_branch
oc aibom list --git-repository=my-org/repo # filter by source_code.git_repository
oc aibom list --serving-engine=vllm # filter by inference.serving_engine
oc aibom list --adaptation-method=lora # filter by fine_tuning.adaptation_method
oc aibom list --optimizer=adamw # filter by training.optimizer
oc aibom list --drift-only # auto-detected dataset != declared dataset
oc aibom list --sort-by=gpu-utilization # rank by a performance metric (highest first)
oc aibom list --sort-by=gpu-power --ascending
Interactive browser¶
Run oc aibom with no subcommand on a terminal (stdout not piped) and it opens a full-screen browser over the same table: move a cursor through the rows and drill into a single AIBOM's describe, a side-by-side compare of several, or the overlaid graph view — without leaving the terminal. Piping (oc aibom | grep …) still prints the plain table. Any --sort-by/--ascending/filter flags you pass seed the browser's initial state.
Keys¶
| Key | Action |
|---|---|
↑ ↓, k j |
Move the cursor (home/end, G jump to ends) |
← →, h l |
Scroll a wide table sideways |
space |
Select / deselect the row |
enter |
Describe the row, or compare when two or more are selected |
g |
Graph the selection (or the row under the cursor) |
s |
Open the sort menu (pick a field and direction) |
f, / |
Open the live filter prompt |
esc |
Clear the selection |
q, ctrl+c |
Quit |
In the sort menu: ↑/↓ pick a field (age plus the --sort-by metrics), space or ←/→ flips the direction, enter applies, esc cancels.
In the filter prompt: type to narrow the list live (a case-insensitive substring over the visible columns), enter keeps the filter, esc clears it.
Inside the describe/compare/graph pages, a [d] Detail view / [g] Graph view tab bar shows where you are; d and g switch between the two views of the same subject, and q/esc backs out to the list.
Filtering¶
All filters are exact-match and case-insensitive, and can be combined. Combined filters are AND'd together.
Sorting¶
--sort-by accepts gpu-utilization, gpu-memory, gpu-power, cpu-usage, memory-usage, network-rx and network-tx. It adds the corresponding column to the table. Add --ascending to put the lowest value first.