Cairn.ink Memory

Cairn Memory

AI セッション間で重要なコンテキストを保持します。状況が変わったら、内容を変更できます。

English · 繁體中文

例を見る · 始め方 · ローカル環境のセットアップ · ホスト環境のセットアップ · 制限事項 · プライバシー

新しい AI セッションを始めるたびに、好みやプロジェクトの決定事項を繰り返し伝えることになりがちです。Cairn はセッション間でコンテキストを保存するメモリーツールを提供します。各メモリーの元となった送信テキストを確認し、状況が変わったときに更新できます。

好みが変わった場合

たとえば、**「レポートは短くしてください。」**と保存したとします。その後、詳細なレポートが必要になった場合は、以前のメモリーとそのソーステキストを確認し、保存した好みを修正するか、忘却してアクティブな検索で利用できないようにできます。

これは明示的なツール操作の図解例であり、チャットクライアントのスクリーンショットではありません。ローカルプレビューでは、ツールを使って保存、確認、修正、忘却を行います。会話を自動的に読み取ることはありません。

• **ソースを確認する。**メモリーとともに保存されたソーステキストを読みます。レシートがあっても、メモリーの内容が真実であることや、正しく解釈されていることの証明にはなりません。
• **変わった内容を修正する。**確認したリビジョンのメモリーを更新します。
• **不要な内容を忘却する。**メモリーをアクティブな検索から削除します。削除とバックアップの対象範囲が適用されます。

ソースレシートとは、メモリーに添付された送信テキストです。メモリーの保存時または修正時にどのような情報が提供されたかを確認するのに役立ちます。会話全体の検証済みトランスクリプトでも、人間の意図を証明するものでもありません。

Cairn Memory と Cairn

Cairn Memoryは、このリポジトリで AI のメモリーを保存、確認、変更するためのオープンソースツールキットです。**Cairn**は、人と AI のためのホスト型共有メモリーマップです。人々が知識を整理、確認、共有できます。

このリポジトリには、ローカルメモリーツールと、ホスト型 Cairn サービスへのコネクターが含まれています。それぞれの利用方法には、固有のセットアップ手順と機能上の制限があります。ローカルでの利用に Cairn アカウントは必要ありません。ホスト環境への接続には、互換性のあるサービスと認証が必要です。

開始地点を選ぶ

目的	こちらから開始	必要なもの
インストールする前に仕組みを理解する	繁體中文 または録画ウォークスルー	インストールもアカウントも不要
オープンソースのツールを自分のコンピューターで試す	ローカルプレビューのセットアップ またはWindows ガイド	ターミナルのセットアップ、Linux x64 および範囲を限定したネイティブ Windows x64 の確認。Cairn アカウントは不要
ドキュメントに記載されたホスト型 Claude Code または Codex 接続を利用する	ホスト型セットアップ	互換性のあるホスト型サービスと認証。ローカルプレビューのクライアントサポートとは別です
メモリレイヤーを基盤に開発する	アーキテクチャとMCP ツール	JavaScript または MCP の統合作業

Claude または Codex を使っていても、通常ターミナルからツールをインストールしない場合は、 まず例と録画ウォークスルーをご覧ください。このプレビューにはセットアップが必要です。 AI ツールを接続する前に、テスト済みのクライアント経路を確認してください。

現在のプレビュー

Cairn のオープンソースのメモリレイヤーは、メモリを独自の SQLite ファイルに保存し、 MCP または JavaScript を通じて公開します。ローカルでの利用に Cairn アカウントは不要です。

開発者向けプレビュー。 インストール後の永続化と、限定的な実モデルのメモリループには 保持されたエビデンスがあります。デフォルトの抽出機能は、 依然として情報源の裏付けに関する基準を満たしていません。既知の制限事項をご覧ください。 保存、確認、修正、削除はモデルキーなしで実行できます。セマンティック検索には OpenAI キーが必要で、 選択されたコンテキストが OpenAI に送信されます。

録画ウォークスルーを見る

36 秒のモデル不使用デモを見る（MP4）。 これは Claude または Codex での会話ではなく、メモリツールの実行を録画したものです。 「モデル不使用」とは、ウォークスルー中に AI モデルを呼び出さないことを意味します。

長い会話での結果については、実モデルを使った 4 ケースのパイロットをご覧ください。 これはオプトイン方式の診断で、Cairn の回答が 1 件失敗したものであり、 デフォルトのクライアントで長期的に想起できる信頼性を測定したものではありません。既知の制限事項

録画されたツールのウォークスルーを開く（GIF）

以下のデモはモデル不使用のループを録画したものです。保存、再起動、確認、修正、 削除を行います。想起のステップでは model_not_configured が返されます。

録画された応答と再生成の手順 · 検証済みの機能とクライアントサポート

## インストール

Claude Code と Codexの場合は、次のワンコマンドインストーラーを実行します。

npx @cairn-ink/memory setup

初回の対話型インストールでは、このコンピューター上のローカル MCP メモリツールを使うか、cairn.ink にサインインしてクラウドの自動メモリを使うかを一度だけ尋ねられます。setup --local または setup --cloud を指定して選択することもできます。初回の非対話型実行では、--local または --cloud が必要です。ローカルモードでは、0.6.0 において自動キャプチャも自動想起も行われません。

インストーラー 0.6.0 は 2026-10-25 に公開されたため、npx @cairn-ink/memory setup ではこのバージョンが使われます。チェックアウトしたリポジトリから node packages/setup/bin/memory.mjs setup を実行することもできます。プラグインのバージョンは 0.3.3 です。 Node ≥22.16 と、PATH 上に少なくとも 1 つの CLI が必要です。クラウドセットアップでは、新しいツールについて確認し、接続済みのツールを更新します。両方を接続する際は、ブラウザーでのサインインは一度だけです。 デフォルトのサーバーは cairn.ink です。サーバーやメモリ ID が競合する場合は選択肢が表示されます。非対話型の競合では何も変更されません。自動メモリを有効にする前に、Codex はフォーマットの適格性チェックに合格する必要があります。 自動化された codex exec の実行では、デフォルトでキャプチャとプロンプトの想起がスキップされます。有効にするには、npx @cairn-ink/memory config --codex-capture-exec on を指定します。

ワークフローに合ったモードを選択してください。

• ローカルプレビュー： SQLite データベースを使い、明示的な MCP メモリツールを利用します。Cairn アカウントは不要です。オープンソースのメモリレイヤーを試す場合は、こちらから始めてください。セマンティック想起には OpenAI のキーが必要です。
• ホステッド連携： cairn.ink 上のメモリを使い、Claude Code プラグインを通じて自動キャプチャと自動想起を行います。Cairn アカウント、トークン、互換性のあるサービスが必要です。明示的なホステッド MCP も利用できます。

ローカルメモリーレイヤーを試す

前提条件：Git、Node >=22.16、npm、tar。記録済みの検証は、Linux x64 と対象を限定したネイティブ Windows x64 インストールを対象としています。 Windows では、PowerShell のセットアップと手順を使用してください。 以下のコマンドでは Linux/WSL のパスを使用しています。他のプラットフォームは未検証です。 このリポジトリからインストールしてください。 スコープなしの npm パッケージと、cairn-memory という名前の PyPI パッケージは、無関係のプロジェクトです。 ローカルアーカイブは、まだ npm に公開されていません。

1. 新しいディレクトリにインストールします。 以下のパスを、管理している既存の親ディレクトリ配下にある新しい絶対パスに置き換えてください。

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

インストーラーはこのチェックアウトをビルドし、インストールスクリプトを実行せずに、固定された公開 npm 依存関係をダウンロードします。 app/、data/、実行可能ファイルのパスと MCP 設定を含む非公開の installation-receipt.json を作成します。 モデルへの呼び出しは行いません。レシートにはローカルパスとユーザー情報が含まれるため、非公開にしてください。インストールの詳細、復旧、バックアップ

2. モデルを使わずにチェックを実行します。 ソースのチェックアウトから、同じ インストールパスを使用してください。チャットクライアントの設定やモデルキーは不要です。

npm ci --prefix adapters/mcp
node adapters/mcp/walkthrough.mjs --executable /absolute/new/cairn-local/app/node_modules/.bin/cairn-memory

status: "passed" が表示されます。このチェックでは、新しい合成データベースを使用して、 5 つのツール、レシート、プロセス再起動後の永続性、修正、忘却を検証します。 子プロセスからモデルキーを削除します。想定される想起結果は model_not_configured です。 手順と期待される結果

3. クライアントを接続します。 非公開のインストールレシートから stdio.command と stdio.args をコピーし、クライアントのローカル MCP 設定に追加してください。セッション間で同じ データベース、所有者、プロジェクトを使用してください。 テスト済みクライアントの一覧を参照してください。

セマンティック想起を使うには、MCP プロセスの シークレット環境変数として OPENAI_API_KEY を明示的に指定してください。手順にあるオプションの --with-recall パスでは、 合成コンテキストを OpenAI に送信するため、モデル利用料金が発生します。組み込みの料金上限はありません。 完全ローカルなモデルの経路は、まだ検証されていません。

Hermes ネイティブプロバイダーについては、個別のセットアップガイドに従ってください。 汎用 MCP 設定の代わりに、プロファイルごとのデータベースと所有者、および CAIRN_MEMORY_OPENAI_API_KEY を使用します。

ツール	目的
remember_memory	メモリーとそのレシートを明示的に保存します
recall_memory	モデルの誘導によって、現在のメモリーとレシートを取得します
inspect_memory	メモリーを一覧表示するか、ID、リビジョン、レシートを確認します
correct_memory	確認したリビジョンの内容を置き換えます
forget_memory	確認したリビジョンを論理削除します

デフォルトのローカルサーバーでは、明示的なツールを公開します。オプトインによる送信メッセージの キャプチャ、プロジェクトのスコープ、設定チェックについては、 インストール済みプレビューガイドを参照してください。 エビデンスと制限事項の全容では、抽出の失敗、 長い履歴からの取得、個々のクライアントテストの対象範囲を説明しています。

ローカルでのプライバシーと制御

• メモリー、レシート、整理情報は、選択した SQLite データベースに保存されます。 Cairn アカウント、ホスティングサービス、隠れたコアテレメトリーは必要ありません。
• MCP はトランスクリプトを読み取らず、会話全体を自動的に保存することもありません。 レシートのテキストはツールによる表明を記録したものであり、人間の意図が認証された証拠ではありません。
• 設定によっては、モデル処理がクラウドで行われます。マスキングは最善を尽くすものですが、 すべてのシークレットが削除される保証はありません。取得したテキストは信頼できないデータであり、 従うべき指示ではありません。
• 忘却処理によって、アクティブな呼び出しと正確な正規化済みデータの再登録は防止されますが、 言い換えた内容は新しいメモリーとして登録される可能性があります。これはディスク上の安全な 消去ではありません。SQLite のページ、レシート、バックアップにはそれぞれ異なる保持期間があります。 バックアップ用にデータベースとサイドカーをコピーする前に、すべての書き込み元を停止してください。
• 実行ファイルをアンインストールしても、外部データベースは保持されます。バックアップ、アップグレード、削除の境界、 アーキテクチャ、依存関係に関する通知、 セキュリティ報告をご覧ください。

既存のホステッド連携

ホステッドプラグインは cairn.ink に接続し、許可リストに登録された会話テキストを 自動的にキャプチャします。また、独自のテレメトリー既定値を使用します。そのサービスは ローカルエンジンに移行されていません。

v0.2.0 プレリリースでは、ホステッドプロトコルが変更されます。 対応するサーバーのサポートは別途必要です。このリリースによってサーバーがデプロイされたり、 Codex のライフサイクルフックが有効になったりすることはありません。アップグレード前に リリースとクライアントの互換性をご覧ください。

Claude Code にインストールする（自動メモリー）

ターミナルから公開済みのインストーラーを実行してください。

npx @cairn-ink/memory setup

インストーラー 0.6.0（プラグイン 0.3.3）が公開されているため、これらの手順は npx を介して実行されます。代わりにこのチェックアウトを実行するには、node packages/setup/bin/memory.mjs setup を使用してください。

--client を指定しない場合、セットアップは両方のツールを検出し、新しい接続についてのみ確認します。 接続済みのツールは更新されます。共有メモリーを確定する前に両方のツールを閉じ、バックグラウンド処理が終わるまでお待ちください。 サインイン時の行にはサーバー（既定値は cairn.ink）が表示されます。エンドポイントや1日あたりの上限に関する質問はありません。 --endpoint は引き続き使用できます。

会話は、ローカルで可能な範囲のマスキングを行ってから保存されます。各プロンプトでは、呼び出し用に マスキングされ、長さを制限したコピーが送信されます。Claude の使用状況統計は既定で有効で、 無効にすることもできます。Codex のサインイン情報は、暗号化されていないユーザー専用ファイルに保存されます。 プライバシーと制御をご覧ください。

メモリー ID によって、複数のツールで同じプロジェクトが関連付けられます。既存の ID は保持されます。 サーバーで競合が発生した場合は、2 つの選択肢が提示されます。安全でない Codex 認証情報の移行には、 事前のログアウトが必要です。独立した ID が 2 つある場合は、どちらか一方を選択してください。 もう一方のキーは、サインインと検証が正常に完了した場合に限りバックアップされ、削除されることはありません。 古いプロジェクトでは、以前の ID に自動的に一致しなくなる場合があります。対話なしで競合が発生した場合、 何も書き込まれません。セットアップが Claude のネイティブなシークレットファイルを読み取ることはありません。 Codex の後に Claude を追加する場合は、インストーラーの認証情報を検証して再利用します。Claude の後に Codex を追加する場合は、同じアカウントを使ってブラウザーで一度サインインする必要があります。 Claude の既存のサインイン情報は保持されます。 自動化された codex exec の実行では、デフォルトで自動取り込みとプロンプトの呼び出しがどちらもスキップされます。有効にするには npx @cairn-ink/memory config --codex-capture-exec on を実行します。デフォルトに戻すには off を指定します。この設定により、exec の取り込みと呼び出しが両方有効になります。有効な場合にのみ status に表示され、セットアップを再実行しても設定は維持されます。 フックは、トランスクリプトのセッションに紐づいた session_meta.payload.source を読み取り、古い CLI スレッドを exec resume で再開する場合はネイティブの exec 親プロセスも検出します。ヘッダーがない場合、または検証できない場合は、取り込みと挿入をスキップします。ヘッダーが検証された対話型セッションは通常どおり続行されます。Codex app-server 上のスレッド（0.160 以降の TUI、VS Code 拡張機能、デスクトップアプリ）は、originator がこれら3つのクライアントのいずれかである場合にのみ対話型として扱われます。それ以外の app-server クライアントは exec として扱われ、同じオプトインが必要です。古い固定ランタイムは、まず setup で更新する必要があります。config を実行すると、正確なコマンドが表示されます。

自動取り込みを維持したままプロンプトの呼び出しを停止するには、npx @cairn-ink/memory prompt-recall-off --client codex を実行します。再度有効にするには prompt-recall-on --client codex を実行します。これは MCP の設定には影響しません。

Codex の自動取り込みはデフォルトで1日あたり200件です。再実行しても既存の上限は維持されます。setup --codex-daily-cap N または config --codex-daily-cap N で変更できます。Status には今日の件数と上限が表示されます。対象を指定しない pause と resume は、インストール済みの Codex を選択します。ペアで実行すると、両方のツールを一時停止します。アンインストールしてもキーとメモリーは保持されます。

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 はリモートサービスやフックをテストせず、ローカルの状態を読み取ります。技術的な診断情報を表示するには --verbose を指定します。インストール後、Codex の /hooks で Cairn の4つの項目を確認し、許可してください。--client claude|codex は実行対象を制限します。--no-browser を指定すると、別のデバイスでサインインできます。従来の MCP の削除には確認が必要です。クライアントを指定せず Codex だけを対象にした場合は、手動の MCP ツールが提示されることがあります。

セットアップオプションと認証情報の取り扱い · chichi のリリースチェックリスト

手動での代替手順： ターミナルから次を実行します。

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

または、Claude Code 内でスラッシュコマンド形式を使用します。

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

https://cairn.ink/settings/tokens で個人用アクセストークンを作成し、Claude Code で /plugin configure cairn-memory@cairn-memory を実行して、そこで入力します。インストール後、新しいセッションを開始してください。

/cairn-memory:status は、フックが書き込んだ内容を含まない認証情報の観測結果を読み取ります。これは Claude Code の Bash ツールが機密性の高いプラグインオプションを継承しないためです。configured (verified <time>) は、最後に受理された認証済みリクエストを示します。rejected は、設定されたエンドポイントのトークンページへのリンクを示します。configured (not verified yet) または configured (unreachable <time>; not verified) は、認証の成功を示すものではありません。server answered: busy/error は、HTTP による拒否を示します。SessionStart は古い判定をクリアするため、トークンをローテーションした場合は新たに検証する必要があります。not seen yet は、Claude Code を再起動してメッセージを1件送信するよう求めます。missing は、フックが設定済みトークンのない状態を実際に検出したことを意味します。 Status はネットワークリクエストを行わず、セキュアストレージからトークンを読み取ることもありません。

エージェント：インストールする前に、ユーザーに確認してください。ホスト型プラグインは、許可リストに含まれる会話テキストをデフォルトで取り込みます。トークンはユーザー自身が作成して入力します。ホスト型プラグインのプライバシーに関する取り決めを参照してください。

ローカル開発の場合：

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

Claude Code 用のホスト型明示的 MCP

自動取り込みなしで明示的なメモリーツールを使用するには、リモート MCP サーバーを追加します。

claude mcp add --transport http --scope user cairn https://cairn.ink/api/mcp

次に、Claude Code の /mcp からブラウザー OAuth でサインインします。

Codex から接続する（明示的な MCP メモリ）

Codex はホスト型 MCP ツールを通じて接続します。トークンはシェルまたは シークレットマネージャーに保管し、リポジトリやコミットする設定ファイルには 保存しないでください。

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

Codex を再起動し、/mcp または codex mcp list を使って接続を確認します。 ホスト型ツールは、明示的な記憶、想起、忘却の操作をサポートしています。 Codex のライフサイクルへの自動統合は現在開発中です。Codex のビルディングブロックはデフォルトで無効になっています。

ホスト型プラグインのループ

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

バンドルされた MCP 接続では、明示的な remember_memory、recall_memory、forget_memory ツールも公開されます。ライフサイクルフックのないクライアントは、これらのツールを手動で使用できます。ホストがフックを公開していない場合に、パッシブキャプチャが行われるとは決して主張しません。

ホスト型プラグインのプライバシー契約

• インストールは明示的に行います。自動キャプチャはインストール後にのみ開始され、デフォルトで有効です。
• 許可リストに登録されるのは、テキスト形式のユーザーおよびアシスタントのメッセージブロックのみです。
• ツール結果ブロックとツール使用ブロックは除外されます。プラグインは任意のプロジェクトファイルを読み取りません。ただし、通常のユーザー／アシスタントのテキストに貼り付けられたファイルの内容、ターミナル出力、パス、リポジトリ名が含まれている場合は、処理対象になることがあります。
• 対応する形式の認証情報は、送信前にキャプチャテキストと自動想起クエリの両方で、ローカルに [REDACTED] に置き換えられます。秘匿化はベストエフォートであり、すべてのシークレットを認識できる保証はありません。多層防御として、ホスト型サービスでも再度秘匿化します。
• 自動想起では、現在のプロンプトの秘匿化された長さ制限付きバージョンが、設定済みのサービスに送信されます。これはキャプチャより前に発生し、別の処理経路です。
• プロンプト想起では、ホストの会話 ID が 1～200 文字の ASCII 許可リスト（A–Z、a–z、0–9、.、_、:、-）に一致する場合に、その ID を送信します。 信頼できるフックが ID を提供し、モデルのテキストから取得することはありません。サーバーは所有者のスコープに限定した SHA-256 ハッシュのみを保存します。 厳格なスキーマを使用する古いサーバーでは、オプションフィールドを含めず、同一のスキーマで一度だけ再試行します。
• プロジェクトスコープは、キー付きの不透明な識別子です。その導出キーはデバイス外に出ず、匿名テレメトリ ID とは別のものです。
• 自動的に推論されるメモリは、個人用またはプロジェクト内限定のままです。チームやコミュニティに公開することはできません。
• プロダクトテレメトリにはコンテンツが含まれず、デフォルトで有効ですが、無効にできます。そのスキーマで受け付けるのは、ライフサイクルイベント、クライアントのバージョン、プラットフォーム、ランダムなインストール ID のみです。
• フックはフェイルオープンで動作します。Cairn の停止やタイムアウトによって、通常の Claude Code の作業が妨げられることはありません。
• キャプチャワーカーは切り離されるため、ヘッドレスの claude -p セッションでも終了処理中にキャンセルされることはありません。許可リストに登録されたデータはワーカーに直接パイプされ、キューファイルには書き込まれません。

/cairn-memory:pause、/cairn-memory:resume、/cairn-memory:status を使って、キャプチャと想起を制御します。

一時停止中のテキストは自動的に遡って取り込まれません。再開後、各セッションの最初の キャプチャフックでは、現在の未処理の履歴（一時停止解除直後のテキストを含む）がスキップされ、 以降の完全なメッセージがキャプチャされます。一時停止前に開始済みのリクエストは完了する場合があります。プライバシーガイドで一時停止の詳細な境界を確認してください。

プライバシーと脅威モデルの全文をお読みください。セキュリティに関する報告は、公開イシューではなく、SECURITY.mdに記載されている非公開の窓口にお寄せください。

公開範囲

このリポジトリは、以下の信頼できる唯一の情報源です。

• Claude Code プラグインとマーケットプレイスのマニフェスト。
• ローカルのトランスクリプトのフィルタリング、編集、プロジェクト ID の導出。
• 公開 HTTP/MCP ワイヤーコントラクトと JSON スキーマ。
• レシート、名前空間の分離、キャプチャのオーケストレーション、MOC による整理、モデル誘導型の想起、修正と削除の抑制機能を備えたローカル SQLite コア。
• オプションの OpenAI アダプター、軽量なローカル MCP ホスト、検査済みのインストール成果物。
• 適合性テストとセルフホスト実装ガイダンス。

Cairn.ink のホスト型抽出サービス、ユーザーデータベース、認証、請求、不正利用対策、本番運用は、別の非公開リポジトリで管理されています。公開サービスの境界については、アーキテクチャとセルフホストをご覧ください。

ステータス

リリース済みのホスト型プラグインと、ローカルの開発者向けプレビューでは、準備状況が異なります。ローカルインストールのライフサイクルは検証済みですが、ソース対応の品質は依然として基準を満たしていません。広範な展開の承認はまだ得られていません。最初の 10 人のユーザーの成果や、スター数の目標が達成されたとは示していません。既知の制限、ROADMAP.md、および提案中の導入実験をご覧ください。

リポジトリにスターを付けて、ローカルプレビューや今後の連携をフォローしましょう。

開発

依存関係のないプラグインランタイムとテストスイートには、Node.js 20 以降が必要です。メンテナー専用の Claude プラグイン検証には Node.js 22 が必要で、プラグインと一緒にインストールされることがないよう、tools/plugin-validation の下に分離されています。

npm test
npm run test:setup
npm run validate
npm ci --prefix tools/plugin-validation
npm run validate --prefix tools/plugin-validation

依存関係をインストールせずに Node >=22.16 でローカルストアを使用する場合：

npm run test:core
npm run demo:store

CONTRIBUTING.mdとdocs/protocol.mdのプライバシー不変条件を読んだうえで、ぜひ貢献してください。