Cairn Memory

Lightweight cross-session memory for AI agents, with receipts.

Cairn Memory gives AI coding agents private, inspectable memory across sessions. Claude Code gets automatic recall before a prompt and automatic capture after a turn. Codex and other MCP clients can use the same hosted memory explicitly through `remember_memory`, `recall_memory`, and `forget_memory`. Every stored memory carries its origin, confidence, scope, timestamps, and a redacted Source Receipt showing why it exists.

It is deliberately small: one Claude Code plugin, one remote MCP connection, no plugin runtime dependencies, and no generic notes UI.

Install for Claude Code (automatic memory)

In Claude Code, run:

/plugin marketplace add Cairn-ink/cairn-memory
/plugin install cairn-memory@cairn-memory

Create a personal access token at `https://cairn.ink/settings/tokens`, then provide it when Claude Code asks for plugin configuration. Start a new session after installation.

For local development:

git clone https://github.com/Cairn-ink/cairn-memory.git
cd cairn-memory
claude --plugin-dir ./plugins/cairn-memory

Connect from Codex (explicit MCP memory)

Codex v0.1 support uses the hosted MCP tools. Keep the token in your shell or secret manager, not in a repository or committed config file:

export CAIRN_MCP_TOKEN='your-token-from-cairn.ink'
codex mcp add cairn \
  --url https://cairn.ink/api/mcp \
  --bearer-token-env-var CAIRN_MCP_TOKEN

Restart Cod