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