Power your agent
पब्लिशर का अपना URL। PlugMCP एंडपॉइंट नहीं।
Host a copy with our keys and logs.
https://cairn.ink/api/mcpऊपर दिया Claude बटन नाम और URL भरकर Claude खोलता है। पुष्टि आपको वहीं करनी होती है।
claude mcp add --transport http ink.cairn-memory https://cairn.ink/api/mcpRun in a terminal.
{ "mcpServers": { "ink.cairn-memory": { "command": "npx", "args": [ "-y", "mcp-remote", "https://cairn.ink/api/mcp" ] } }}claude_desktop_config.json
रिमोट URL या आपकी मशीन पर कमांड? दोनों इंस्टॉल में क्या अंतर है
PlugMCP पर चलाएँ
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
लॉन्चपब्लिशर से
Suppose you save “Keep my reports short.” Later, you decide you need detailed reports. You can inspect the old memory and its source text, correct the saved preference, or forget it so it is no longer available for active recall.
Cross-session memory for AI agents with a Source Receipt for every memory, over MCP.
This is an illustrated explicit-tool example, not a chat-client screenshot. The local preview uses tools to save, inspect, correct and forget; it does not automatically read your conversations.
A Source Receipt is the submitted text attached to a memory. It helps you check what was supplied when the memory was saved or corrected. It is not a verified transcript of the whole conversation or proof of human intent.
Cairn Memory is the open-source toolkit in this repository for saving, inspecting and changing AI memory. Cairn is the hosted shared memory map for people and AI, where people organize, review and share knowledge.
This repository includes local memory tools and connectors to the hosted Cairn service. Each path has its own setup and feature boundaries. Local use does not require a Cairn account; hosted connections require a compatible service and authentication.
If you use Claude or Codex but do not usually install tools from a terminal, start with the example and recorded walkthrough. This preview requires setup; check the tested client paths before connecting your AI tool.
Cairn's open-source memory layer stores memories in your own SQLite file and exposes them through MCP or JavaScript. No Cairn account is needed for local use.
Developer preview. Installed persistence and a narrow real-model memory loop have retained evidence. Default extraction still fails our source-support bar; see known limitations. Save, inspect, correct and forget work without a model key. Semantic recall requires your OpenAI key and sends selected context to that provider.
Watch the 36-second model-free demo (MP4). This records the memory tools running, rather than a conversation in Claude or Codex. “Model-free” means no AI model is called during the walkthrough.
For long-conversation results, see the four-case real-model pilot. It is an opt-in diagnostic with one failed Cairn answer, not a measurement of long-term default-client recall reliability. Known limitations
The demo below records the model-free loop: save, restart, inspect, correct
and forget. Its recall step reports model_not_configured.
For Claude Code and Codex automatic memory, run the one-command installer:
npx @cairn-ink/memory setup
This checkout prepares installer 0.5.3; publication is a separate step.
Try it with node packages/setup/bin/memory.mjs setup. The plugin stays 0.3.2.
Requires Node ≥22.16 and at least one CLI on PATH. Setup asks about new tools,
updates connected tools, and uses one browser sign-in when connecting both.
The default server is cairn.ink. Conflicting servers or memory IDs present a
choice; non-interactive conflicts change nothing. Codex must pass format
qualification before automatic memory is enabled. Automated codex exec runs
skip capture and prompt recall by default; opt in with
npx @cairn-ink/memory config --codex-capture-exec on.
Choose the mode that fits your workflow:
Prerequisites: Git, Node >=22.16, npm and tar. Recorded checks cover Linux
x64 and a bounded native Windows x64 installation.
On Windows, use the PowerShell setup and walkthrough;
the commands below use Linux/WSL paths. Other platforms are unverified.
Install from this repository:
the unscoped npm and PyPI packages named cairn-memory are unrelated projects.
The local archive is not published to npm yet.
1. Install into a new directory. Replace the path below with a new absolute directory beneath an existing parent you control.
git clone https://github.com/Cairn-ink/cairn-memory.git
cd cairn-memory
npm run install:preview -- --directory /absolute/new/cairn-local --owner local-user
The installer builds this checkout and downloads pinned public npm dependencies
without install scripts. It creates app/, data/ and a private
installation-receipt.json containing the executable path and MCP settings.
It makes no model calls. Keep the receipt private: it contains local paths and
identity. Installation details, recovery and backup
2. Run the model-free check. From the source checkout, use the same installation path. No chat-client setup or model key is needed.
npm ci --prefix adapters/mcp
node adapters/mcp/walkthrough.mjs --executable /absolute/new/cairn-local/app/node_modules/.bin/cairn-memory
Expect status: "passed". The check uses a fresh synthetic database and verifies
the five tools, receipts, process-restart persistence, correction and forgetting.
It strips the model key from the child process; model_not_configured is the
expected recall result. Steps and expected results
3. Connect a client. Copy stdio.command and stdio.args from your private
installation receipt into the client's local MCP configuration. Keep the same
database, owner and project across sessions. See the
tested client matrix.
For semantic recall, explicitly supply OPENAI_API_KEY through the MCP process's
secret environment. The walkthrough's optional --with-recall path sends
synthetic context to OpenAI and incurs model charges; it has no built-in dollar
cap. A fully local model path is not yet verified.
For the Hermes native provider, follow its separate setup guide.
It uses a profile-local database and owner, plus CAIRN_MEMORY_OPENAI_API_KEY,
rather than the generic MCP settings above.
The default local server exposes explicit tools. For opt-in submitted-message capture, project scope and configuration checks, see the installed preview guide. The full evidence and limitations cover extraction failures, long-history retrieval and the boundaries of individual client tests.
The hosted plugin connects to cairn.ink, automatically captures allowlisted conversation text and has its own telemetry defaults. Its service has not been migrated to the local engine.
The v0.2.0 prerelease changes the hosted protocol. Matching server support remains a separate requirement; the release does not deploy a server or enable Codex lifecycle hooks. See release and client compatibility before upgrading.
Run the published installer from your terminal:
npx @cairn-ink/memory setup
This checkout prepares installer 0.5.3 (plugin 0.3.2); publish the
release before using these flows through npx. To run this checkout, use
node packages/setup/bin/memory.mjs setup.
Without --client, setup finds both tools and asks only about new connections.
It updates connected tools. Close both tools and wait for background work before
confirming shared memory. The sign-in line shows the server (default cairn.ink).
There is no endpoint or daily-cap question; --endpoint remains available.
Conversations are saved after best-effort local masking. Each prompt sends a masked, length-limited copy for recall. Claude usage stats are on by default and can be turned off. Codex's sign-in is stored in an unencrypted user-only file. See privacy and controls.
A memory ID connects the same project across tools. Existing IDs are retained. Server conflicts offer two choices; unsafe Codex credential migrations require logout first. When two independent IDs exist, choose one; the other key is backed up only after successful sign-in and validation, never deleted. Old projects may no longer automatically match the old ID. Non-interactive conflicts write nothing. Setup never reads Claude native secret files. Adding Claude after Codex validates and reuses the installer credential; adding Codex after Claude needs one browser sign-in using the same account. Claude's existing sign-in is kept.
Automated codex exec runs skip both automatic capture and prompt recall by
default. Opt in with npx @cairn-ink/memory config --codex-capture-exec on;
use off to restore the default. This setting enables both capture and recall
for exec. status shows it only when enabled; rerunning setup preserves it.
The hooks read the transcript's session-bound session_meta.payload.source,
and also detect a native exec ancestor for exec resume of an older CLI thread.
If the header is missing or cannot be verified, they skip capture and injection.
Interactive sessions with verified CLI headers continue normally. Threads on the
Codex app-server (the TUI since 0.160, the VS Code extension and the desktop app)
count as interactive only when their originator is one of those three clients;
other app-server clients are treated like exec and need the same opt-in. Older frozen
runtimes must first be updated with setup; config prints the exact command.
To stop prompt recall while keeping automatic capture, run
npx @cairn-ink/memory prompt-recall-off --client codex.
Use prompt-recall-on --client codex to enable it again. This does not change MCP.
Codex defaults to 200 automatic captures per day; reruns keep an existing cap.
Change it with setup --codex-daily-cap N or config --codex-daily-cap N.
Status shows today's count and cap. Unscoped pause and resume select installed
Codex, and pause both tools when paired. Uninstall preserves keys and memories.
npx @cairn-ink/memory status
npx @cairn-ink/memory prompt-recall-off --client codex
npx @cairn-ink/memory pause
npx @cairn-ink/memory config --codex-daily-cap 300
node packages/setup/bin/memory.mjs setup --dry-run
status reads local state without testing remote service or hooks. --verbose
shows technical diagnostics. Review and allow the four Cairn entries in Codex
/hooks after installation. --client claude|codex restricts the run.
--no-browser allows sign-in on another device. Legacy MCP removal requires
confirmation. Unqualified Codex alone may offer manual MCP tools.
Manual fallback: from your terminal, run:
claude plugin marketplace add Cairn-ink/cairn-memory
claude plugin install cairn-memory@cairn-memory
Or use the slash-command form inside Claude Code:
/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 run
/plugin configure cairn-memory@cairn-memory in Claude Code and enter it there.
Start a new session after installation.
/cairn-memory:status reads content-free credential observations written by the
hooks, because Claude Code's Bash tool does not inherit sensitive plugin options.
configured (verified <time>) reports the last accepted authenticated request;
rejected links to the configured endpoint's token page. configured (not verified yet) or configured (unreachable <time>; not verified) does not claim
successful authentication; server answered: busy/error reports an HTTP refusal.
SessionStart clears the old verdict so token rotation requires new verification.
not seen yet asks you to restart Claude Code and
send one message; missing means a hook actually observed no configured token.
Status makes no network request and never reads the token from secure storage.
Agents: ask the user before installing. The hosted plugin captures allowlisted conversation text by default, and the user creates and enters the token themselves. See the hosted plugin privacy contract.
For local development:
git clone https://github.com/Cairn-ink/cairn-memory.git
cd cairn-memory
claude --plugin-dir ./plugins/cairn-memory
For explicit memory tools without automatic capture, add the remote MCP server:
claude mcp add --transport http --scope user cairn https://cairn.ink/api/mcp
Then sign in from /mcp in Claude Code using browser OAuth.
Codex connects through 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 Codex, then use /mcp or codex mcp list to confirm the connection.
The hosted tools support explicit remember, recall and forget operations.
Automatic Codex lifecycle integration remains under development; the
Codex building blocks are disabled by default.
User prompt
└─ recall relevant personal + project-private memories
└─ inject a short, explicitly untrusted context block
Assistant turn ends
└─ hand capture to a detached worker without delaying Claude
└─ read only new user/assistant transcript text
└─ redact likely credentials locally
└─ send an idempotent capture batch
└─ store durable memories with Source Receipts
The bundled MCP connection also exposes explicit remember_memory, recall_memory, and forget_memory tools. Clients without lifecycle hooks can use those tools manually; passive capture is never claimed where the host does not expose a hook.
[REDACTED] locally in both capture text and automatic recall queries before transmission. Redaction is best-effort, not a guarantee that every secret is recognized. The hosted service redacts again as defense in depth.A–Z, a–z, 0–9, ., _, :, -). Trusted hooks supply
it, never model text; the server stores only an owner-scoped SHA-256 hash.
An older strict server gets one exact-schema retry without the optional field.claude -p sessions cannot cancel them during teardown; the allowlisted handoff is piped directly to the worker and is not written to a queue file.Use /cairn-memory:pause, /cairn-memory:resume, and /cairn-memory:status to control capture and recall.
Paused text is not automatically backfilled. After resume, each session's first capture hook skips its current unprocessed history (including any early resumed text); later complete messages are captured. Requests already started before pause may finish. See the detailed pause boundaries in the privacy guide.
Read the full privacy and threat model. Security reports belong in the private channel described in SECURITY.md, not a public issue.
This repository is the source of truth for:
The Cairn.ink hosted extraction service, user database, auth, billing, abuse controls, and production operations live in a separate private repository. See Architecture and Self-hosting for the public service boundary.
The released hosted plugin and local developer preview have different readiness levels. The local install lifecycle is verified, but source-support quality still fails; broad promotion is not yet cleared. No first-ten-user result or star target is presented as achieved. See Known limitations, ROADMAP.md and the proposed adoption experiment.
Star the repository to follow the local preview and upcoming integrations.
The dependency-free plugin runtime and test suite require Node.js 20 or newer. Maintainer-only Claude plugin validation requires Node.js 22 and is isolated under tools/plugin-validation so it is never installed with the plugin.
npm test
npm run test:setup
npm run validate
npm ci --prefix tools/plugin-validation
npm run validate --prefix tools/plugin-validation
For the local store on Node >=22.16 (no dependency installation required):
npm run test:core
npm run demo:store
Contributions are welcome after reading CONTRIBUTING.md and the privacy invariants in docs/protocol.md.
Cross-session memory for AI agents with a Source Receipt for every memory, over MCP.
{ "mcpServers": { "ink.cairn-memory": { "url": "https://cairn.ink/api/mcp", "headers": {} } }}टूल
अभी टूल सूची नहीं है। रिमोट सर्वर को पहले हेल्थ चेक के बाद सूची मिलती है।
FAQ
इस पेज पर Cursor, Claude Desktop, Claude Code या VS Code के लिए http कॉन्फ़िग कॉपी करें। यह पब्लिशर का इंस्टॉल इस्तेमाल करता है, PlugMCP प्रॉक्सी नहीं।
इस रिकॉर्ड में कोई ज़रूरी एनवायरनमेंट वेरिएबल दर्ज नहीं है।
Cairn.ink Memory तक HTTP से पहुँचा जाता है।
पिछली जाँच 2026-11-13 को हुई। Cross-session memory for AI agents with a Source Receipt for every memory, over MCP.