CLI Reference

Complete reference for the axis command-line interface. All commands can be run directly or via npx @netlify/axis.

`axis run`

axis run [options]

Execute scenarios against configured agents.

-c, --config <path> Config file (default: axis.config.json).

-s, --scenario <key> Run a specific scenario by key.

-a, --agent <name> Run with a specific agent only.

--json JSON output to stdout (no live terminal display).

-v, --verbose Detailed per-step logging.

-o, --output-dir <dir> Also write report files to this directory.

--concurrency <n> Max parallel jobs.

--debug Capture raw agent stdout for debugging.

--no-score Skip scoring (raw results only).

--refresh-skills Force re-clone remote skills.

--compare-baseline [name] Compare against a baseline after scoring.

axis reports [reportId] [scenarioKey] [options]

View past AXIS reports.

[reportId] Report ID or latest. Omit to list all reports.

[scenarioKey] Drill into a specific scenario detail.

-a, --agent <name...> Filter by agent(s), repeatable.

--json Output as JSON.

--html Open report in browser.

-n, --limit <count> Max reports to list (default: 10).

axis baseline set [name]

Create or update a baseline snapshot from a report.

--from <reportId> Use a specific report (default: latest).

axis baseline list

List all saved baselines.

axis baseline show [name]

Display baseline contents.

--json Output as JSON.

axis baseline compare [name]

Compare a report against a baseline. Exits with code 1 if regressions are detected.

--report <reportId> Specific report to compare (default: latest).

--json Output as JSON.

axis baseline delete [name]

Delete a saved baseline.