All shelves / Mods / Workflow
cairn
By jmgirard
cairn is a Claude Code workflow mod by jmgirard.
Draws the milestone in flight above the prompt as a plan, implement, and review track with a percent, opens a /cairn-pane, and holds merges and force-pushes.
DrawsHolds a command
Install
The marketplace name is cairn.
claude plugin marketplace add jmgirard/cairn claude plugin install cairn@cairn
It runs inside the Claude Code process. The side panel is only what the author's README names. Read the repo before you install, or run claude plugin validate on the plugin folder.
- Version
- 2.1.0
- License
- MIT
- Repo stars
- 4
- Last change
- 2026-10-30
What it can reach
- Draws in the session
- Holds a command
- Sees tool calls
- Calls another program on this machine
The README recommends a dev install instead, a clone symlinked into ~/.claude/skills; pick one, since both load the plugin twice. The marketplace install is a frozen snapshot: install again for a new release. Then run /cairn-init in the repo. The band needs Claude Code 2.1.287 or later, where mods are on by default, and draws in the terminal and the desktop app. The guard hooks start at the next session and do nothing in repos cairn does not track.
The marketplace name is cairn, and it holds only this plugin, which also brings the milestone skills, rules, templates, and guard hooks. The milestone band is why this page files it under workflow. roadmap-jasonwarrenuk, by JasonWarrenUK, draws a /ready pane of the tasks ready in a dependency-graph roadmap. project-sentinel, by Arjun0014, draws a status bar with milestones, context, cache, and the 5-hour window. This one reads cairn/ROADMAP.md and draws one row: the milestone in flight with its track and percent, or the next one you can start. /cairn-pane adds the open pull requests and issues, the candidate rows, and the latest release. The blocking hooks hold a merge for your approval and a force-push to your default branch. In the source, those guards are PreToolUse command hooks in hooks/hooks.json that run Python scripts.
Demo
![The milestone band section of the cairn README: a band above the prompt with one row for the milestone in flight, or the next one you can start, the id and title at the left and the flow track and percent at the right, drawn as text: M010 Nested tasks and a capital X, [track], 88%.](/thumbs/cairn-shot-1600.f09765f0a7.webp)
What it hooks into
session.startWhen a session startsclassic.SessionStartA Claude Code eventcommand.runWhen you run its slash commandui.renderDraws into the sessionPaneAbovePromptturn.completeWhen a turn endsclassic.StopA Claude Code eventprompt.submitWhen you send a promptskill.promptA Claude Code eventtool.callAround a tool call, where it can hold oneEditWriteMultiEditsession.endWhen a session ends
Read from the on() calls in its hook modules. Open its source under Files to check what each one does.
Hooks 9
SessionStartpython3 "${CLAUDE_PLUGIN_ROOT}/hooks/session_context.py" || py -3 "${CLAUDE_PLUGIN_ROOT}/hooks/session_context.py"Stoppython3 "${CLAUDE_PLUGIN_ROOT}/hooks/stop_guard.py" || py -3 "${CLAUDE_PLUGIN_ROOT}/hooks/stop_guard.py"PreToolUse · Bashpython3 "${CLAUDE_PLUGIN_ROOT}/hooks/merge_guard.py" || py -3 "${CLAUDE_PLUGIN_ROOT}/hooks/merge_guard.py"PreToolUse · Bashpython3 "${CLAUDE_PLUGIN_ROOT}/hooks/commit_guard.py" || py -3 "${CLAUDE_PLUGIN_ROOT}/hooks/commit_guard.py"PreToolUse · Bashpython3 "${CLAUDE_PLUGIN_ROOT}/hooks/force_push_guard.py" || py -3 "${CLAUDE_PLUGIN_ROOT}/hooks/force_push_guard.py"PreToolUse · Writepython3 "${CLAUDE_PLUGIN_ROOT}/hooks/memory_guard.py" || py -3 "${CLAUDE_PLUGIN_ROOT}/hooks/memory_guard.py"PreToolUse · mcp__.*__spawn_taskpython3 "${CLAUDE_PLUGIN_ROOT}/hooks/idea_guard.py" || py -3 "${CLAUDE_PLUGIN_ROOT}/hooks/idea_guard.py"PostToolUse · Bashpython3 "${CLAUDE_PLUGIN_ROOT}/hooks/merge_guard_post.py" || py -3 "${CLAUDE_PLUGIN_ROOT}/hooks/merge_guard_post.py"PostToolUseFailure · Bashpython3 "${CLAUDE_PLUGIN_ROOT}/hooks/merge_guard_post.py" || py -3 "${CLAUDE_PLUGIN_ROOT}/hooks/merge_guard_post.py"
Files
The author's README and source, 4 files. They load when you open them.
Facts
- Author
- jmgirard
- Category
- Workflow
- Marketplace
- cairn
- Repo
- jmgirard/cairn
- Version
- 2.1.0
- License
- MIT
- Repo stars
- 4
- Last change
- 2026-10-30
- Language
- Python
- Files
- 770