Memoir — AI skill for Claude Code

Memoir

Portable, project-scoped memory and session handoffs for coding agents.

Memoir keeps decisions, rationale, goals, and next actions in readable local files. An MCP server lets an agent save and retrieve that context. Optional local, Git, and cloud backups move it between machines.

The reliability changes are described in [the remediation record](docs/AUDIT-REMEDIATION.md). Review the [upgrade and recovery guide](docs/RELIABILITY-ROLLOUT.md) before upgrading clients that share encrypted backups.

Continue between Codex and Cursor on this computer

Memoir includes a separate, project-only handoff. It carries answered questions, decisions, next actions and receipts from checks actually run through Memoir. It does not import personal memory or transcripts.

The project handoff, browser view and recovery commands below require version 3.16.0 or later:

npm install -g memoir-cli@3.16.0
cd /path/to/your/project
memoir work setup
memoir work resume
memoir work view

For source development, install dependencies and replace `memoir` with `node bin/memoir.js` from the Memoir checkout.

Open **this same folder and branch** in Codex or Cursor and say **“Continue this project.”** The managed instructions use the project MCP connection, or the included CLI fallback when the connection is unavailable. Existing settings and approval policies are preserved. Agent adherence is still required; ordinary terminal checks are not captured automatically.

The **project view** opens in your browser on this computer. Search saved answers, see why a check needs repeating, correct a decision, or remove it from the next handoff. Removed records can be restored; earlier versions stay in local history. Keep the view's terminal open while using it, and press Ctrl+C to stop. You can also ask your agent **“Open my Memoir project view.”** See the [local view validation](docs/PROJECT-VIEW-VALIDATION.md) for actual browser tests and the limits of the fresh-session continuity resu