AX CLI
Canonical command reference for the AX CLI.
ax is the command-line interface for the AX agent experimentation platform.
- Create an experiment:
ax experiment create - Run it:
ax experiment run, then inspect runs withax run - Analyze your data:
ax experiment queryandax run query - Save your insights:
--saveon a query, orax insight
Output modes
When you run a command in a terminal, results print as readable tables. When
you pipe or redirect the output, list commands switch to headerless TSV and
query commands stream JSONL rows, so scripts can parse either. Override with
--json (always wins) or AX_FORCE_TTY=1 (keep the table format when piping).
Command index
| Command | Use |
|---|---|
ax experiment | Author, validate, run, and query experiments. |
ax run | List, inspect, watch, cancel, rerun, and upload/download runs. |
ax insight | Manage org-scoped saved SQL insights. |
ax auth | Log in and show identity status. |
ax org | List, view, switch, and invite to organizations. |
ax credit | View prepaid credit balance and usage spend, or buy more credit. |
ax secret | Manage org-scoped secret values. |
ax api-key | List and revoke API keys. |
ax llm-provider | Manage org BYOK LLM providers and the 514.ax AI gateway. |
ax integrations | GitHub integration status and repo → experiment links. |
| Utilities | update, send-debug, release-notes, ci upload. |
Legacy commands (not in v0.6)
These still exist for compatibility but are outside the v0.6 reference surface:
| Legacy command | Use instead |
|---|---|
ax results ... | experiment query for experiment summaries, run query for single-run SQL |
ax runs ... | run list / run view / run watch |
ax intro | experiment create --template cli-install (same flags required) |