perdure

Export Claude Code session JSONLs to portable, human-readable markdown archives. Preserves raw dialogue, summarizes tool calls, strips operational noise. Archive the current session, a specific session id, or pass "all" to sweep every un-archived session in the project. Use at the end of a significant session, before /compact, before upgrading Claude Code, or when returning to a project after a gap.

Close a workflow record properly — rot-lint it, verify the review gate, set the terminal status, fill the Outcome, run the ADR promotion pass, and regenerate the HANDOFF page. Use when work on a workflow is finished (or abandoned) and its record should go terminal without lying.

Resume a previously started perdure workflow. Reads the workflow's persistent state file, re-injects its plan, findings, decisions, and current step into the conversation so the session can continue where it left off — even after compaction, /clear, or a new session. Use when coming back to a multi-step task that was paused.

Check the records against the population of sessions — how much of the work that ran is linked to a written record. Use when asked "how many sessions produced records?", "is anything undocumented?", or before trusting a project's records as a complete account. Reports; never accuses.

Create a new Architecture Decision Record (ADR) in perdure/decisions/. Use for significant architectural, technological, or design choices that should be traceable months or years from now. Not for trivial decisions — those stay in workflow files.

List architectural decision records (ADRs). Shows active decisions by default; --all adds every status plus decisions recorded inside workflow files; --reindex rebuilds perdure/decisions/INDEX.md from the ADR files' frontmatter.

Generate (or freshness-check) the HANDOFF page — a derived one-page orientation view at perdure/HANDOFF.md built only from records that pass the record-rot lint. Use before handing work off, after closing a workflow, or when someone asks "where do we stand?". Pass --check to verify the committed page still matches the records.

Show perdure configuration health — the plugin-specific checks that first-party /doctor and /plugin list don't know about. Reports the CLAUDE.md marker block, preferences, records state, and whether the installed plugin version lags the source/marketplace. Read-only.

Set up perdure in Claude Code. Adds the records directive to your ~/.claude/CLAUDE.md and runs a short preferences interview; every change is shown as a diff first and reversible via /perdure:uninstall. The plugin works without this — install makes the model reach for records on its own.

List all perdure workflows in the current project. Scans perdure/workflows/*.md directly and shows active, parked, completed, and abandoned workflows. Use to see what's in progress, what's done, and what to resume.

Sweep or verify the session index at perdure/raw/INDEX.jsonl — one committed line per session recording identifiers, timestamps, counts and content digests, with no transcript text. Use to establish the population of sessions behind a project's records, to check the index still matches the transcript store, or when asked "how many sessions produced these records?".

Start a new perdure workflow with a persistent state file. Creates perdure/workflows/YYYY-MM-DD-<slug>.md per the records convention and prepares the state structure to be updated at each checkpoint. Use at the start of any complex multi-step task that should survive compaction, /clear, or be resumable later — this is the entry point of the golden loop (start → work → review gate → close/archive).

Reverse the changes made by /perdure:install. Removes the perdure records directive from your CLAUDE.md and deletes the preferences file (all backed up first). Does not uninstall the plugin itself — use /plugin uninstall for that.

Run the workflow's closing review gate — obtain an independent substantive review of a defined scope (a workflow's modified files, a path, or an explicit list) and append the verdict to the workflow file in the records convention's schema. Use after implementation is complete and before declaring a workflow done. Accepts any independent reviewer — a reviewer the user names, an installed review agent, a generic read-only subagent carrying the inline rubric below, or a human — returning APPROVE / APPROVE WITH IMPROVEMENTS / DENY with file:line evidence.