# clavue

> Execution-first AI coding CLI with verification-driven plans, long-session continuity, and provider routing. Current published version: `8.10.1`.

Clavue is the first CLI coding agent where plan steps are executable, verification is automatic, and the model cannot claim "done" without proving it with a command that exits clean. Distributed via npm; runs on Node ≥ 18; macOS, Linux, WSL, Windows.

## Install

- npm: `npm install -g clavue@8.10.1`
- npx: `npx -y clavue@8.10.1`
- curl: `curl -fsSL https://unpkg.com/clavue@8.10.1/install.sh | bash -s -- 8.10.1`

## What makes clavue different

- Plans are executable markdown: each step carries `**Verify**: <command>` (optional `**Expect**: <substring>`).
- The `VerifyPlan` tool runs the commands, captures stdout/stderr, auto-marks passing steps `**Verified**: <iso>` in the plan file, and emits `ALL_VERIFIED` only when every check passes.
- Three slash commands for the verification workflow: `/verify-plan`, `/verify-stats`, `/verify-reset`.
- Plan lint catches malformed steps before any command runs (8 error codes including expect_without_verify, verified_without_verify, multiple_verify).
- Verify-gap and finish-line reminders auto-nudge the model when verification is overdue or a plan is fully verified but no summary was written.
- Per-failure-reason guidance turns every `non_zero_exit` / `expect_mismatch` / `timeout` / `spawn_error` into an actionable next step.
- JSONL verify log at `<projectDir>/verify-log.jsonl` captures per-step pass/fail history for flake-spotting across sessions.

## Long-conversation continuity

- 12-section compact summary template: Task Scope, User Constraints, Active Work State, Files In Play, Key Decisions, Open Issues, Resolved Questions, Pending User Asks, Critical Context, Pending Tasks, Exact Next Step, Retrieval Hints.
- REFERENCE-ONLY preamble on post-compact resume messages prevents the resumed turn from re-executing already-resolved work.
- `/compact --focus "topic"` biases ~60-70% of summary budget toward a named subject.
- Cross-compact tasks/todos snapshot via `post_compact_tasks` attachment — model does not forget the in-flight task list.
- Plan progress (verified vs pending step indices) is embedded in the V1 PostCompact hook schema as `plan_progress` and injected into the summarizer prompt.

## Provider routing

- Provider is a route, not identity: Anthropic direct, OpenAI-compatible gateways, CCR proxies, custom URLs.
- Configure via `/provider` slash command or `clavue provider` CLI.
- Per-slot model override (Primary / Sonnet / Haiku / Opus).
- Validation + repair: `clavue provider doctor`, `clavue provider probe`.

## Native repo tools

- File operations: Read, Edit, Write, Glob, Grep.
- Shell: Bash with permission gates, PowerShell on Windows.
- Worktrees as first-class tools (`EnterWorktree` / `ExitWorktree`).
- Tasks: TaskCreate / TaskUpdate / TaskList / TaskGet (V2), TodoWrite (V1).
- Skill system: bundled + dynamic + MCP.
- Subagents: AgentTool returns last-message text only (strict isolation).
- LSP integration for type-aware navigation.

## Slash commands

- `/compact [--focus "topic"]` — shrink context, optionally biased.
- `/verify-plan [stepIndex]` — run plan verify commands, auto-mark Verified on pass.
- `/verify-stats [limit]` — per-step pass rate + recent failure reasons from the verify log.
- `/verify-reset [stepIndex...]` — clear stale Verified markers after editing step code.
- `/provider` — configure API routing.
- `/model` — pick main-loop model.
- `/resume`, `/status`, `/usage`, `/memory`, `/theme`.

## Links

- Website: https://www.clavue.com
- Docs: https://www.clavue.com/docs
- Pricing: https://www.clavue.com/pricing
- Source: https://github.com/mycode699/clavue
- npm: https://www.npmjs.com/package/clavue