cairn-statusline-setup

/cairn:cairn-statusline-setup

Wire this developer's ~/.claude/settings.json statusline to the cairn bundle. Once configured, every Claude Code session shows a compact one-line badge in the prompt's status row:

⬡ cairn  [signal]  [ctx-meter pct%]

Signal priority (first match wins):

• ⏳ adopt <phase> X/Y (P%) ~Nm — live during cairn-adopt long phases
• ⚠ N unattested — bypass commits since cairn init
• ⚑ N pending — pending decision drafts in attention queue
• ◐ gc — GC sweep in progress
• TSK-... <title> — active task in flight
• ✓ N·M — idle heartbeat showing N decisions and M invariants in scope (positive signal that Cairn is alive)
• (empty) — fresh adoption with no ground state yet; just brand + ctx meter

Step 1 — surface the inline prompt

Render via AskUserQuestion:

Wire the cairn statusline into your user-level settings? It shows a one-line ground-state summary in every Claude Code session.

• [a] set it up now
• [b] skip — re-run /cairn:cairn-statusline-setup later

Step 2 — locate the shim file

The plugin's SessionStart hook writes the bundle's current path to ~/.claude/plugins/cache/<slug>/.active-version-path on every session open, where <slug> is the marketplace name Claude Code installed the plugin under. The shim is a single line: the absolute path to the active dist/cli.mjs. Resolve it with a Node glob over ~/.claude/plugins/cache/*/.active-version-path that picks the most-recently-written shim by mtime — never hardcode the slug:

const { readdirSync, statSync } = require('node:fs');
const { homedir } = require('node:os');
const { join } = require('node:path');
const base = join(homedir(), '.claude', 'plugins', 'cache');
let shim = null, newest = 0;
for (const slug of readdirSync(base)) {
  const p = join(base, slug, '.active-version-path');
  try {
    const m = statSync(p).mtimeMs;
    if (m >= newest) { newest = m; shim = p; }
  } catch {}
}

If empty, the plugin's SessionStart hook hasn't fired even once for the current install. Surface this enumerated cause list: