ClaudeCodeMod

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.

In your shell
claude plugin marketplace add jmgirard/cairn
claude plugin install cairn@cairn
Open the repo

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%.
Screenshot of the author's GitHub page.

What it hooks into

  • session.startWhen a session starts
  • classic.SessionStartA Claude Code event
  • command.runWhen you run its slash command
  • ui.renderDraws into the sessionPaneAbovePrompt
  • turn.completeWhen a turn ends
  • classic.StopA Claude Code event
  • prompt.submitWhen you send a prompt
  • skill.promptA Claude Code event
  • tool.callAround a tool call, where it can hold oneEditWriteMultiEdit
  • session.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

Other mods in Workflow

agent-panelkoomaiSends one question to a panel of Claude subagents at the models and efforts you pick, shows each seat live in a /panel-view pane, and writes a verdict page.watchtowerlazygophersOpens a pane of the session's last 50 agent returns and main replies, newest first, each folded to a preview you click to open. The README is in Chinese.check-ledgerLeeHigma0201Shows the last real check and how many files changed since on the status line, with /evidence and a tool Claude reads before it says tested.mod-scoutLeeHigma0201Scans your last 14 days of transcripts, ranks the mods you would use most in a pane, and asks Claude to design the top ones with a bundled skill.resume-nudgeLeeHigma0201Drafts a pick-up prompt in the prompt box, with a toast, when a session reopens after a restart cut a turn off. Enter sends it; /resume-here sends it for you.leek-skillsleekDraws a band above the prompt of the subagents its skills dispatch, a /scratch pane of every .scratch/ effort, and a ticket board while a spec is built.github-issuesMarcoCarnevaliOpens a side pane of a repository's GitHub issues as cards, with tabs, search, and labels. Work on it hands one to Claude, and a toast marks a new assignment.task-boardMarcoCarnevaliOpens a To do, Doing, Done board in a side pane that fills from Claude's to-do list and approved plans, takes your own cards, and gives Claude a board tool.clocks-bandNarenDawarDraws a band above the prompt of each Bash command, MCP call, and subagent that has run past 5 seconds, with its elapsed time against its limit.cannibal-guardNicoSKOOLHolds a commandRefuses a new page whose target keyword your site already covers or ranks for, and tells Claude to improve the existing page instead.client-pulseNicoSKOOLDraws a band above the prompt with a client's Search Console clicks and impressions week over week, tracked keyword moves, AI citations, and the top query.repo-issuesno1cromoOpens a pane counting the repository's open GitHub issues by issue type and by assignee, in GitHub's colours, and shows the total on the status line.
All 396 in Workflow