CLI Reference
Core Vaner CLI commands for setup, Prepared Work, MCP, cockpit, and diagnostics.
Recommended first-run flow
vaner init --path .
vaner up --path .
vaner status --path .
vaner doctor --path .
vaner down --path .vaner init probes hardware, picks a sensible
policy bundle, and detects supported AI clients.
Skip prompts with --non-interactive.
Setup
vaner setup show # Current bundle + reasons + hardware
vaner setup recommend # JSON-out (programmatic)
vaner setup apply <bundle-id> # Persist + hot-reload running daemon
vaner setup advanced # Open config in $EDITOR
vaner setup hardware # Print HardwareProfile.detect()See Policy bundles for the catalog and Configuration for the full knob surface.
Advanced daemon controls
Most users should use vaner up and vaner down. Use these only when you need
separate process control:
vaner daemon start --once false --path .
vaner daemon serve-http --path .
vaner daemon status --path .
vaner daemon stop --path .Prepared Work via HTTP/MCP
Prepared Work is normally consumed through desktop, cockpit, or MCP clients. The daemon exposes the same surface over loopback HTTP:
curl -s http://127.0.0.1:8473/prepared-work | jq
curl -s http://127.0.0.1:8473/work-products | jqUse vaner.prepared_work.dashboard in MCP clients for the UI-safe card feed.
Diagnostic clients can use vaner.work_products.* for inspect, export,
dismiss, and feedback flows.
Scenario cockpit commands
vaner scenarios list --limit 10 --path .
vaner scenarios show <scenario_id> --path .
vaner scenarios expand <scenario_id> --path .
vaner scenarios compare <scenario_a> <scenario_b> --path .
vaner scenarios outcome <scenario_id> --result useful --skill vaner-feedback --path .Prompt-time reasoning and comparison
vaner query "where is auth enforced?" --path .
vaner why --path .
vaner compare "Summarize auth flow" --path .
vaner impact --path .Local debugging and state control
vaner inspect --last --path .
vaner metrics --path . --output summary
vaner prepare --path .
vaner precompute --path .
vaner forget --path .Skill loop commands
vaner distill-skill <decision-id> --path . [--out-dir PATH] [--name NAME] [--force]vaner init also installs a managed vaner-feedback skill into .cursor/skills/vaner/ and .claude/skills/vaner/.
Live monitoring and diagnostics
vaner watch --cockpit-url http://127.0.0.1:8473
vaner logs --path .
vaner logs --events --cockpit-url http://127.0.0.1:8473
vaner show --cockpit-url http://127.0.0.1:8473
vaner status --path .
vaner ps --path .
vaner doctor --path .Configuration and profile controls
vaner config show --path .
vaner config show --json --path .
vaner config keys --path .
vaner config get backend.model --path .
vaner config set intent.enabled true --path .
vaner config set intent.skills_loop.enabled true --path .
vaner config set gateway.routes.gpt- https://api.openai.com/v1 --path .
vaner config edit --path .
vaner profile show --path .
vaner upgradeMCP server
vaner mcp --path .
vaner mcp --path . --transport sse --host 127.0.0.1 --port 8472The stdio form is the default for Claude Code, Cursor, Codex CLI, VS Code, Windsurf, Zed, Continue, Cline, Roo, and Claude Desktop.
Optional capability: OpenAI-compatible gateway
vaner proxy --path . --host 127.0.0.1 --port 8471Use this only when your client cannot call MCP tools directly.
Evaluation flows
vaner eval --path .
vaner run-eval --cases-file examples/evals/basic.jsonl --path .Version and completion
vaner --version
vaner --install-completionRun vaner --help and vaner <subcommand> --help for full flags.