ax agent
Inspect exact agent versions and their model compatibility.
| Command | Use |
|---|---|
agent list | List registered agent versions and model compatibility. |
agent validate | Check the exact agent versions and compatibility an experiment would use. |
agent version | Inspect one exact agent version. |
These commands require authentication and an active organization. All accept
--org <ORG_ID> to target another organization for one command. agent list
and agent version accept --json for machine-readable output. Arguments
marked required must be supplied.
Compatibility status
Compatibility is tracked for an exact agent version and canonical model
combination. The status field has three values:
| Status | Meaning |
|---|---|
verified | A hosted run reached a normal end of turn after the model responded. The run's tests may have passed or failed. |
unknown | No conclusive runtime evidence has been recorded. The combination remains eligible to run. |
unsupported | The agent explicitly rejected the selected model. Normal submissions omit the combination and report a warning. |
Only unknown changes automatically. Its first conclusive hosted outcome sets
the combination to verified or unsupported; later runs do not replace that
status. A model absent from the canonical catalog is reported as unknown with
a catalog-miss warning.
In JSON output, each compatibility entry includes the canonical model id,
status, and an optional reason:
{
"compatibility": [
{
"canonical_model_id": "anthropic/claude-opus-4-8",
"status": "verified",
"reason": null
}
]
}agent list
List registered agents, exact versions, and model compatibility.
ax agent list [AGENT]| Argument / flag | What it does |
|---|---|
[AGENT] | Limit results to one agent, such as claude, codex, or cursor. |
--json | Print the canonical registry objects as JSON. |
agent validate
Check an experiment through the same agent-version admission rules used when you submit it.
ax agent validate <EXPERIMENT.yaml>| Argument / flag | What it does |
|---|---|
<EXPERIMENT.yaml> | Required. Path to the experiment file. |
The output shows the exact selected version and compatibility status for each
requested agent and model. Catalog misses remain eligible as unknown and
print a warning. The command exits non-zero when the experiment cannot be
admitted.
agent version
Inspect one exact agent version, its artifact digests, and model compatibility.
ax agent version <AGENT> <VERSION>| Argument / flag | What it does |
|---|---|
<AGENT> | Required. Agent registry name. |
<VERSION> | Required. Exact agent version. |
--model <MODEL> | Limit compatibility to one model id or catalog-backed alias. |
--json | Print the canonical registry object as JSON. |