@isaacriehm/cairn
v0.33.0
Published
Cairn — state + context-loading layer for AI coding agents.
Readme
@isaacriehm/cairn
The cairn CLI binary. Bootstrap + debug entrypoint for the Cairn state +
context-loading layer.
Install
npm install -g @isaacriehm/cairnSubcommands
| Subcommand | What |
|------------|------|
| cairn init | One-time adoption walk for a new repo. Seeds .cairn/, runs the mapper, ingests existing docs + source comments + rules. |
| cairn join | Per-clone bootstrap. Sets core.hooksPath = .cairn/git-hooks, ensures sessions dir. Idempotent. |
| cairn hook <event> | Shared hook runners for Claude Code, Cursor, and Codex. |
| cairn mcp serve | Stdio MCP server. Registered by each supported host adapter. |
| cairn doctor | Verify the local install is healthy. |
| cairn fix | Auto-resolve doctor warnings where possible. |
| cairn attention | List pending DEC drafts + baseline findings. |
| cairn gc | Garbage-collection sweep against canonical zone. |
| cairn scope | Scope-index commands (rebuild, etc.). |
| cairn status-line | Format the per-session Claude Code status line. |
The shared agent plugin (@isaacriehm/cairn-plugin) is the primary operator
surface for Claude Code, Cursor, and Codex. This CLI is what the plugin shells
out to and what new contributors run when bootstrapping a clone.
See the repo root README.md and
docs/ARCHITECTURE.md for the broader
picture.
License
MIT — see ../../LICENSE.
