Cairn Remembers

Cairn

知識を築き、手がかりを残す。 — 現代の探検家のためのツールです。

AI エージェントとあなたのための、ローカルファーストなエピソード記憶です。

ケルンとは、道しるべとして積み上げられた石の山です。このケルンは、あなたの 思考の軌跡を示します。あらゆる決断、行き止まり、その理由がノードとなり、あなたやあらゆるモデルが、セッションやモデル世代をまたいで再び見つけられます。

• ローカルファースト — すべては ~/.cairn/ 内の 1 つの SQLite ファイルに保存されます。クラウドもアカウントもテレメトリーもありません。
• モデル非依存 — シェルコマンドを実行するエージェント、または MCP を使うエージェントであれば、どれでも利用できます。Claude、GPT/Codex、Gemini、ローカルモデルに対応します。
• 追記のみ — メモリーは無効化されますが、削除されることはありません。記録はそのまま残ります。
• あなたのもの — Cairn があなたのマシンの外へデータを送ることはありません。チャットは、Cairn がない場合と同じように、選んだモデルに送信されます。ローカルモデルを使えば、データが外部へ出ることはありません。

始め方は 2 通りです：

• 🧑 ご自身でセットアップしますか？ このまま読み進めてください — クイックスタートは約 5 分で完了します。すべてのオプションと解決方法については、QUICKSTART.mdをご覧ください。
• 🤖 誰かのために AI エージェントが Cairn をインストールしますか？ → SETUP_FOR_AGENTS.mdは、インストール、同意、クレジット表記について、エージェント向けに書かれています。

Cairn の内部を見る

あとで戻って確認したい決断、理由、未完了の作業を残しておきましょう。Cairn はそれらをローカルの保管庫に保存し、あなたと接続済みの AI ツールが読み取り、追加できます。それぞれの AI は独自のメモリーとコンテキストを保持します。以下のデモでは、記録を探索するためのオプションのダッシュボードを紹介します。

ハブ	プロジェクト	接続
未完了の作業を再開できます。	関連する作業をまとめておけます。	関連付けられたメモリーを探索できます。

5 つすべてのデモと説明を見る。

• ハブ — 9 秒
• プロジェクト — 18 秒
• インデックス — 6 秒
• ライブフィード — 14 秒
• 接続 — 8 秒

ローカル環境にインストールして録画しました。プライベートなテキストには例を使用し、コントロールとソースの帰属表示はそのまま残しています。撮影したインストール環境について、リリース 0.3.3 のすべてのコントロールとの整合性は確認されていません。デモの説明と録画に関する注記。

目次

• クイックスタート
• AI を接続する
• できること
• 上級者向けインストール
• 複数アカウント
• バックアップするもの
• よく使うコマンド
• ライセンス

クイックスタート

混同しないように、場所は2つあります。 🖥️ ターミナル（PowerShell／ターミナル）— このページのコマンドはすべて、お使いのコンピューター上でここから実行します。接続設定は常にターミナルコマンドか設定ファイルの編集で行います。AI にターミナルの手順を代わりに実行させることもできます（以下の最速の方法です）が、接続設定をチャット欄に貼り付けることはありません。 💬 AI チャット — メモリが表示される場所であり、AI に使うよう頼んで接続設定をテストする場所です。

最速 — AI に任せる

Claude Code、Codex、または Cursor を開いて、次を貼り付けます。

https://github.com/CairnRemembers/cairn から Cairn をインストールして設定してください

AI がターミナルの手順を実行し、メモリを有効にする前に確認します。お使いのコンピューター上の AI ごとに「はい／いいえ」で一度確認し、既定値は いいえ です。あなたが「はい」と答えない限り、何も記録されません。(Codex をお使いですか？ その後に貼り付けがもう1つあります。AI を接続するをご覧ください。)

または自分で行う

1 — インストール 🖥️ (ソフトウェアのみをインストールします。何も記録されず、ボールトは空の状態で始まります)

⚠️ Linux／WSL に [all] をインストールしますか？ 先に pip install torch --index-url https://download.pytorch.org/whl/cpu を実行してください。そうしないと、pip は不要な数GBの CUDA 版 torch 一式をインストールします。Windows と macOS の torch ホイールは、すでに CPU 専用です。

pip install cairn-remembers            # base install
pip install "cairn-remembers[all]"     # + embedder + dashboard

ソースからインストール

より充実した方法です。インストーラーが CPU 版 torch の手順も行います。

コードを取得 🖥️

git clone https://github.com/CairnRemembers/cairn
cd cairn

インストーラーを実行 🖥️

# Windows:      .\install.ps1      (blocked? powershell -ExecutionPolicy Bypass -File .\install.ps1)
# macOS/Linux:  ./install.sh

インストーラーは Python 3.11 以降を検出し、必要なものをすべてインストールします（初回実行時に PyTorch をダウンロードします。Linux／Windows では軽量な CPU 版で、数分かかります）。その後、動作を確認します。

2 — AI を接続します。 ここでメモリが実際に有効になります。また、AI ごとに接続方法が異なります。セットアップで y を入力すれば Claude Code の設定は完了しますが、Codex や Claude Desktop の設定は完了しません。お使いの AI を以下から見つけて、✅ の項目まで進んでください。

AI を接続する

Cairn には独立した2つの接続方法があります。その違いを知っておけば、よくある戸惑いをすべて避けられます。

• キャプチャ — チャットを自動的に記憶します（ボールトに書き込みます）。
• ツール — AI がチャット内からボールトを検索し、メモを記録できます（読み取りと、必要に応じた書き込み）。

必要な接続方法は AI によって異なり、1つの場合も2つの場合もあります。最初の ✓ で終わらせず、お使いの AI の ✅ の行まで進んでください。

Claude Code — コマンド1つ

🖥️ ターミナルで実行します。

python -X utf8 -m cairn setup        # answer y for Claude Code

これでキャプチャが接続されます。Claude Code の新しいチャットはすべて自動的にコンテキストを引き継ぎ（バナーが表示されます）、作業中に記録し、終了時にまとめを作成します。マシン全体に一度だけ設定され、元に戻せます（cairn disconnect --global）。1つのプロジェクトだけで使いたい場合は、代わりにそのリポジトリ内で cairn connect を実行してください（全体設定とプロジェクトごとの設定は併用できません。doctor がその状態を検出します）。

✅ 完了の確認: 新しいチャットを開いたときに 「CAIRN — inherited context」 バナーが表示され、🖥️ python -X utf8 -m cairn doctor に ✓ capture と表示されます。

任意 — ネイティブツール: Claude Code は、シェルで cairn コマンドを実行すれば、すでにボールトを読み取れます。代わりにネイティブの cairn_* ツールを使うには、import cairn を実行できる Python を指定して、MCP サーバーをユーザー全体に登録します（cairn をインポートできない単なる python を指定するのが、最もよくある失敗です。まずパスを確認してください。QUICKSTART §6a）。

claude mcp add --scope user cairn -- <full-path-to-python> -X utf8 -m cairn mcp

💬 確認方法：チャットで 「cairn_orient を呼び出して」と頼みます。（doctor ではこの接続を確認できません。依頼してテストしてください。）

OpenAI Codex — 3 つの要素がそれぞれ異なる役割を担います

1. キャプチャ 🖥️ — python -X utf8 -m cairn setup → Codex の場合は y（= codex-hook install）。 Codex が notify を実行すると、会話のターンをリアルタイムでキャプチャします（ターン ID で重複を排除）。ディスク上のすべてを網羅的に取り込むには、いつでも 🖥️ python -X utf8 -m cairn import codex-sessions --apply を実行します。
2. ツール 📄 — ~/.codex/config.toml に追加してから、Codex を完全に再起動します (§6 の完全な手順):

[mcp_servers.cairn]
command = "<full-path-to-python>"
args = ["-X", "utf8", "-m", "cairn", "mcp"]
startup_timeout_sec = 30
tool_timeout_sec = 120
default_tools_approval_mode = "approve"

3. 習慣 📄 — ~/.codex/AGENTS.md を作成し、QUICKSTART §6c のメモリプロトコルを貼り付けると、Codex が自発的に状況を把握し、情報を取得して、記録します。（要素 2 が必要です。プロトコルがこれらのツールを呼び出します。）

✅ 完了の目安： 🖥️ python -X utf8 -m cairn codex-hook status を実行すると INSTALLED と表示され、💬 Codex のチャットで 「call cairn_orient」 と依頼すると、要約が返ってきます（要素 3 がある場合、最初の返信は [cairn: oriented — N] で始まります）。 ⚠️ 正直な補足： cairn doctor は Codex の MCP 登録（[mcp_servers.cairn] ブロック）の構造を検出しますが、サーバーが起動することや notify フックがキャプチャすることまでは証明しません。実際の確認には、上記のチェックを使ってください。

Claude Desktop / Cursor — 貼り付けは 1 回

📄 claude_desktop_config.json（または Cursor の MCP 設定）に追加してから、アプリを再起動します：

{
  "mcpServers": {
    "cairn": { "command": "python", "args": ["-X", "utf8", "-m", "cairn", "mcp"] }
  }
}

これが ツール の接続設定です。チャット内から検索、取得、探索、記録ができます。これらの環境には 自動キャプチャ機能がありません。AI に cairn_note を依頼した内容だけが保存されます。（アプリが Python を見つけられない場合は、Cairn のインストールに使った Python のフルパスを指定してください。）

✅ 完了の目安： doctor に ✓ MCP — registered in Claude Desktop config と表示される（Desktop）か、💬 「call cairn_orient」 のスモークテストで応答が返ります（Cursor）。

上記のすべての AI に適用されます：

• 接続設定は 1 回だけです。 新しいチャットでは自動的に記憶が使われるため、チャットごとに有効化する必要はありません。orient は記憶を読み取るだけで、有効化はしません。接続方法によって範囲は異なります。Claude Code のフックはマシン全体に適用されます（または cairn connect で 1 つのプロジェクトに適用）。Desktop／Cursor と Codex の設定は、各アプリの設定内にあり、アカウントごとに適用されます。
• 新しい接続設定が反映されるのは新しいチャットのみです。接続設定を終えてから、新しいチャットを開いてください。（長時間起動している MCP クライアントでツールを再読み込みするには、完全な再起動が必要です。）
• プライバシー制御： 1 つのチャットでスキップするには、そのシェルで CAIRN_CAPTURE=0 を設定します（PowerShell $env:CAIRN_CAPTURE="0" · cmd set CAIRN_CAPTURE=0 · bash export CAIRN_CAPTURE=0）。すべての場所で一時停止するには、cairn capture off / on を使います。書き込み前にシークレットは除去されます（追記のみ、フェイルクローズ）。
• 元に戻す： cairn disconnect [--global] · cairn codex-hook uninstall · 設定を確認するには cairn setup を再実行します。

利用できる機能

• 1 つの保管庫を、あらゆるモデルで共有。 MCP に対応するか cairn を実行できるエージェントであれば、同じ記憶を読み書きできます。そのため、競合他社のモデル間でも、あるエージェントが別のエージェントの書き込みをもとに作業できます。
• 利用上限に達しても、作業の続きを進められます。 あるモデルの上限に達したら、別のモデルに切り替えて、前回の続きから始められます。作業の記録はモデルのコンテキストではなく、保管庫に残ります。
• 作業中にキャプチャ。 接続した時点から、意思決定、行き詰まり、ツール呼び出し、会話のターンが検索可能なノードになります。
• 残しておきたい情報は失われません。 キャプチャした各ターンの全文が保存されます。検索結果は要約であり、索引です。cairn read <id> は任意のノードの全文を出力し、MCP の cairn_read は max_chars を引き上げて全文を取得します。
• 自分で実行するローカルのメンテナンス処理。 cairn sleep を習慣として毎晩、または独自のスケジューラーで実行します（自動ではスケジュールされません）。埋め込み → 統合 → プルーニング → グラフ再構築 → コンパイルをすべて自分のマシンで行います。「ネットワーク不要」の例外は、最初の埋め込み時に約 80 MB のモデルを 1 回ダウンロードすることです。
• 思考の地図。 ダッシュボードの銀河（cairn dashboard → http://127.0.0.1:7331）に加え、人が読める Hub / Book / Index も利用できます。
• 過去の会話の取り込み。 古い会話を、明確で相互につながった claim ノードに要約します。

高度なインストール

# Linux / WSL: install the CPU-only PyTorch first, or pip pulls a ~4.6 GB CUDA
# stack you don't need. (Want a GPU build? Install your torch first, then run the
# line below — it's preserved.) macOS: skip this line — its default wheel is CPU/MPS.
pip install torch --index-url https://download.pytorch.org/whl/cpu

pip install -e ".[all]"      # package + embedder + dashboard

pip install -e ".[embeddings]"   # no dashboard
pip install -e ".[dashboard]"    # no embedder

python3 -m venv .venv && source .venv/bin/activate && ./install.sh

複数のアカウント

AI ごとにログインが1つなら、ここは読み飛ばして構いません。そのまま使えます。 各 AI はそれぞれのアカウントでサインインし、Cairn はその AI の作業を自動的に専用の銀河に保存します。Claude と GPT が混ざることはなく、設定も不要です。

同じ AI のアカウントを2つ使う場合のみ（Claude のログインが2つ、ChatGPT/Codex のログインが2つ、たとえば個人用と会社用など）、続きを読む価値があります。銀河は各ログインの変わらない ID に紐づいており、決して統合されません。ただし、同じマシンで同じ AI のログインを2つ使っている場合、Cairn はどちらがアクティブかを常に確実に判断できるとは限りません。混乱を防ぐためのルールは次のとおりです。

自動判定ではなく、明示してください。アカウントごとに事前に CAIRN_ACCOUNT を設定します。

# Claude Code — launch each account with its label:
export CAIRN_ACCOUNT=work && claude        # bash/zsh (or set it in that profile)
#   PowerShell: $env:CAIRN_ACCOUNT="work"; claude
# Codex — put it in that account's ~/.codex/config.toml:
#   [mcp_servers.cairn]  env = { CAIRN_ACCOUNT = "work" }
# Importing old history? Always pass the flag:
cairn import <export> --source=claude --account=work

名前はいつでも設定・管理できます。

cairn account                          # list galaxies + node counts
cairn account rename <key> "Company"   # display label only — never merges or deletes
cairn account doctor                   # read-only check — prints the exact fix command per mismatch
cairn account fix-session <session-id> <slug>   # re-file ONE named session (backed up, then locked)
cairn account fix-session <slug>                # same, for the current session only

正直な制限事項 — 不意の事態を避けるために：

• Claude Desktop はセッションごとにアクティブなアカウントを自動で確認できます。Claude Code CLI と Codex は確認できません — マシン上の現在のログインファイルに従うため、アカウントを切り替えると、以前のアカウントでセッションが気づかないうちに記録されることがあります。保証となるのは CAIRN_ACCOUNT であり、自動判定ではありません。
• account doctor は確認可能な情報（Claude Desktop のセッション）を検証します。CLI のみ、または Codex の履歴は監査できません。
• ここでも追記専用です。名前の変更で変わるのは表示ラベルのみです。統合や削除は行われません。

バックアップ対象

フォルダーは1つだけです。ボルトの ~/.cairn/（実際の記憶が保存される cairn.db）をバックアップしてください。それ以外はすべて再作成できます。コードは GitHub 上にあり、再インストールでボルトが変更されることはありません。

よく使うコマンド

orient · note · fetch · wander · query · read（任意のノード全体を表示） · dashboard · doctor · setup · connect / disconnect / capture · account · backfill · sleep（メンテナンスサイクル — 自分で実行します） · edges · book · import

すべてのオプションを含む完全なリファレンス：QUICKSTART.md。

ライセンス

Business Source License 1.1 に基づき、個人および非商用での利用は無料です。読んだり、実行したり、変更したり、セルフホストしたりできます。商用または業務での利用には商用ライセンスが必要です。[email protected] までメールでお問い合わせください。ソースコードは公開されています（OSI の定義による「オープンソース」ではありません）。各リリースは、LICENSE に記載された変更日に、許諾条件の緩やかな MIT License に移行します。

特許出願中 — Cairn の中核的な仕組みを対象とする米国の仮特許出願は、2026-07-07 に提出されました。Cairn Remembers™ は James Wescott Maitland IV の商標です。

知識は目的地ではなく、歩んだ道のりです。