ax model
Find models and the agent versions that support them.
| Command | Use |
|---|---|
model list | List models and the agent versions that support them. |
This command requires authentication and an active organization. It accepts
--org <ORG_ID> to target another organization for one command and --json
for machine-readable output.
model list
List models and the agent versions that support them.
ax model list [--agent <AGENT[@VERSION]>] [--all-versions] [--model-family <FAMILY> | --model <MODEL>...]| Argument / flag | What it does |
|---|---|
--agent <AGENT[@VERSION]> | Limit results to one agent. cursor selects its latest stable version; cursor@<VERSION> selects an exact version, including a pre-release. |
--all-versions | List every supporting version, not only the latest. Cannot be combined with an exact @<VERSION>. |
--model-family <FAMILY> | Limit results to one catalog model family, such as google/gemini-flash or gemini-flash. A bare name that several labs share, such as flux, is rejected with the <LAB>/<FAMILY> choices. |
--model <MODEL> | Limit results to this model id or catalog alias. Repeat for more models. Requested models stay listed, with None, when no selected agent version supports them. Cannot be combined with --model-family. |
An agent version supports a model only when the pairing is
supported: its status is verified and the
model is on the agent's model menu. This is the rule validation and submission
use, so every listed pairing validates and runs, and a pairing that is not
listed is skipped. Untested pairings, whether unknown or not yet in the
registry, are not listed; test one with
ax agent test. Without --agent, each agent shows
the most recent stable version that supports the model, which is the version
an experiment without a version or saved pin runs for that model alone. It is
labeled latest
when it is that agent's newest stable version. --json reports each listed
version's status, which is always verified, and a prerelease flag.
A pre-release is never latest and runs only when
pinned. It is listed only with --all-versions or an exact @<VERSION>,
labeled pre-release, as in Codex (0.161.0-alpha.9, pre-release).
The models listed are those some selected agent version supports.
Model families come from the platform's canonical model catalog, which is
updated with each platform release; your local CLI version does not change
them. The Family: line shows the family as resolved, for example
google/gemini-flash for --model-family gemini-flash. Some models have no
catalog family, so no family filter can match them. When a family filter is
set, those models are listed after the results; check them with --model.
Examples:
# Models supported by Cursor's latest version
ax model list --agent cursor
# Which Cursor versions support two specific models
ax model list --agent cursor --all-versions \
--model anthropic/claude-haiku-4-5 --model openai/gpt-5-miniPiped output is one tab-separated row per model: the canonical model id, the
supporting <AGENT>@<VERSION> pairs separated by commas, then the model's
<LAB>/<FAMILY>. Either of the last two is - when empty. --json includes
each model's family (null when it has none), the resolved model_family,
and models_without_family.