# CLI reference

Every command below has its own page with arguments, options, and aliases. `ariadnev` and `av` are interchangeable everywhere.

## Commands in this release

| CLI reference | Every ariadnev command |
| --- | --- |
| [`ariadnev`](/en/stable/reference/cli/ariadnev/) | Install a curated, quality-gated workflow kit across coding-agent targets. |
| [`ariadnev adapters`](/en/stable/reference/cli/adapters/) | Adapter artifacts projected from the install receipt, for tools that read that format |
| [`ariadnev adapters regenerate`](/en/stable/reference/cli/adapters-regenerate/) | Rebuild the artifacts from the receipt (deterministic — a repair, not a reconcile) |
| [`ariadnev add-skill`](/en/stable/reference/cli/add-skill/) | Scaffold a new canonical skill in the kit |
| [`ariadnev audit`](/en/stable/reference/cli/audit/) | Compare installed files against the receipt, or scan the scripts the kit ships |
| [`ariadnev backups`](/en/stable/reference/cli/backups/) | List or restore ariadnev-managed backups |
| [`ariadnev config`](/en/stable/reference/cli/config/) | Inspect ariadnev's own configuration |
| [`ariadnev config prefs`](/en/stable/reference/cli/config-prefs/) | Show the settings in effect after both config layers are applied |
| [`ariadnev contract`](/en/stable/reference/cli/contract/) | Print the provider×artifact capability contract (--json for machines) |
| [`ariadnev doctor`](/en/stable/reference/cli/doctor/) | Health-check the installed kit against its receipt |
| [`ariadnev eval`](/en/stable/reference/cli/eval/) | Score kit quality — tier-1 static; tier-2 behavioral suite; optional tier-3 LLM judge |
| [`ariadnev install`](/en/stable/reference/cli/install/) | Install the kit to one or more providers |
| [`ariadnev journal`](/en/stable/reference/cli/journal/) | The technical journal: one dated entry per notable event |
| [`ariadnev journal create`](/en/stable/reference/cli/journal-create/) | Write a dated entry |
| [`ariadnev journal list`](/en/stable/reference/cli/journal-list/) | List entries, newest first |
| [`ariadnev journal show`](/en/stable/reference/cli/journal-show/) | Print one entry, by file name or a fragment of it |
| [`ariadnev journal validate`](/en/stable/reference/cli/journal-validate/) | Check every entry has a title, a date, a status, and a body |
| [`ariadnev kit`](/en/stable/reference/cli/kit/) | Where the kit installs from and to |
| [`ariadnev kit install-path`](/en/stable/reference/cli/kit-install-path/) | Show where each artifact kind would be written for a provider |
| [`ariadnev kit refresh`](/en/stable/reference/cli/kit-refresh/) | Discard the extracted kit cache and extract it again |
| [`ariadnev list`](/en/stable/reference/cli/list/) | Show kit contents and per-provider install state |
| [`ariadnev mcp`](/en/stable/reference/cli/mcp/) | MCP servers this project and this user have configured |
| [`ariadnev mcp add`](/en/stable/reference/cli/mcp-add/) | Add a stdio server to this project (or to your own config with --global) |
| [`ariadnev mcp list`](/en/stable/reference/cli/mcp-list/) | List configured servers across both scopes |
| [`ariadnev mcp remove`](/en/stable/reference/cli/mcp-remove/) | Remove a server from this project (or from your own config with --global) |
| [`ariadnev mcp show`](/en/stable/reference/cli/mcp-show/) | Show one server's definition (env variable names only, never values) |
| [`ariadnev mcp verify`](/en/stable/reference/cli/mcp-verify/) | Start each server and check it completes the MCP initialize handshake |
| [`ariadnev migrate`](/en/stable/reference/cli/migrate/) | Relocate installed files when provider path conventions change |
| [`ariadnev plan`](/en/stable/reference/cli/plan/) | The plan this branch is working from |
| [`ariadnev plan archive`](/en/stable/reference/cli/plan-archive/) | Move a finished plan under the archive dir |
| [`ariadnev plan check`](/en/stable/reference/cli/plan-check/) | Mark a phase completed |
| [`ariadnev plan cleanup`](/en/stable/reference/cli/plan-cleanup/) | List finished plans still in the plans root; --archive moves them |
| [`ariadnev plan close`](/en/stable/reference/cli/plan-close/) | Mark the plan completed |
| [`ariadnev plan list`](/en/stable/reference/cli/plan-list/) | List plan directories with their status and phase progress |
| [`ariadnev plan phase`](/en/stable/reference/cli/plan-phase/) | Print one phase file in full |
| [`ariadnev plan reindex`](/en/stable/reference/cli/plan-reindex/) | Re-read every plan and report what is malformed (there is no index to rebuild) |
| [`ariadnev plan resolve`](/en/stable/reference/cli/plan-resolve/) | Print the directory of the plan this branch points at |
| [`ariadnev plan search`](/en/stable/reference/cli/plan-search/) | Search every plan's files |
| [`ariadnev plan show`](/en/stable/reference/cli/plan-show/) | Show the plan this branch points at, with its phases |
| [`ariadnev plan status`](/en/stable/reference/cli/plan-status/) | Show or set the plan's own status |
| [`ariadnev plan uncheck`](/en/stable/reference/cli/plan-uncheck/) | Put a phase back to pending |
| [`ariadnev plan update`](/en/stable/reference/cli/plan-update/) | Set a phase's status, in the phase file and the index table |
| [`ariadnev plan use`](/en/stable/reference/cli/plan-use/) | Point this branch at a plan directory under the plans dir |
| [`ariadnev query`](/en/stable/reference/cli/query/) | Show recorded ariadnev history (installs \| doctor \| history) |
| [`ariadnev run`](/en/stable/reference/cli/run/) | Validate or execute a versioned graph workflow |
| [`ariadnev run cancel`](/en/stable/reference/cli/run-cancel/) | Request cooperative cancellation for an active run |
| [`ariadnev run resume`](/en/stable/reference/cli/run-resume/) | Resume a durable run with the original graph and runtime identity |
| [`ariadnev run status`](/en/stable/reference/cli/run-status/) | Read durable status without invoking a provider |
| [`ariadnev skill`](/en/stable/reference/cli/skill/) | Manage the Python environment a skill's scripts need, and run those scripts |
| [`ariadnev telemetry`](/en/stable/reference/cli/telemetry/) | Anonymous telemetry status (stateless, off unless configured; opt out with ARIADNEV\_TELEMETRY\_DISABLED=1) |
| [`ariadnev uninstall`](/en/stable/reference/cli/uninstall/) | Remove a previously installed kit (receipt-based, preserves user-modified files) |
| [`ariadnev update`](/en/stable/reference/cli/update/) | Self-update to the latest ariadnev release (--check to only report, --to to pin an exact version) |
| [`ariadnev validate`](/en/stable/reference/cli/validate/) | Lint the kit source (frontmatter, sizes, references, cross-skill routing) without installing |