Linksee Memory

Claude Code のセッション間記憶喪失を解決するための MCP サーバー。ローカル SQLite に 6層構造化メモリ を永続保存し、複数 AI ツール(Cursor / OpenAI Codex / Gemini CLI)から同じ記憶ベースにアクセスできる。

作者: Michie@Linksee Memory GitHub: https://github.com/michielinksee/linksee-memory LP: https://linksee-site.vercel.app

なぜ必要か

Claude Code Memory や CLAUDE.md の auto-memory は「WHAT(何を編集したか)」は記録できる。しかし「WHY(なぜその修正が必要だったか・どう失敗したか・次回も同じ罠を踏まないための教訓)」が消える。

Linksee Memory はこの「WHY の喪失」を構造化メモリで補完する。

6層メモリ構造

内容特記
goalこのプロジェクト / タスクで達成したいこと
contextなぜ今これをやっているか・制約・前提
emotionユーザーの tone(frustration / excitement)
implementation何を試して何が成功 / 失敗したか
caveat「絶対に X するな」の教訓自動忘却から保護
learning振り返って残った insight

caveat 層の特別性

  • Ebbinghaus の忘却曲線に相当するような自動削除から protected
  • recall 時に上位に表示される
  • 「同じ失敗を二度しない」を構造で担保する仕組み

活用のコツ

caveat 層を「ただのメモ」として使うのではなく、「絶対に X するな」という否定形・教訓形で保存すると recall 精度が高くなる。

インストール(5分)

# Step 1: Node.js v20+ の確認
node --version
 
# Step 2: MCP サーバー登録
claude mcp add -s user linksee -- npx -y linksee-memory
 
# Step 3: 自動発動 Skill のインストール(必須)
npx -y linksee-memory-install-skill

Claude Code を完全終了→再起動後、mcp__linksee__remember / mcp__linksee__recall ツールが使える状態になれば完了。

Skill を入れ忘れない

Step 3 の Skill インストールを skip すると、Claude が自発的に recall を呼ばない。ツールは登録されているが使われない状態になる。公式ドキュメントには記載がないため落ちやすい罠。

Stop Hook による自動保存

~/.claude/settings.json に以下を追加すると、セッション終了時に自動的に記憶を保存できる。

{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          { "type": "command", "command": "npx -y linksee-memory-sync" }
        ]
      }
    ]
  }
}

処理時間:約 100ms。失敗しても silent(Claude を block しない)。

Claude Code Memory との比較

項目Claude Code Memory (MEMORY.md)Linksee Memory
保存形式Flat な Markdown ファイルSQLite(6層構造化)
書き手Claude が自動書き込みClaude が自動書き込み(Skill 経由)
WHY の保存弱い強い(implementation / caveat 層)
自動忘却保護なしcaveat 層は protected
セッション終了時の自動保存標準搭載Stop hook で設定可能
クロスツール対応Claude Code のみCursor / Codex / Gemini CLI も共有可能

クロスツール記憶共有

同じ SQLite ファイルを Cursor / OpenAI Codex / Gemini CLI からも参照できる。AIツールを切り替えても記憶が引き継がれる cross-agent 永続記憶 が実現する。

ロードマップ(OSS → Pro tier)

  • 現在(v0.3.0): OSS でローカル SQLite 永続化
  • Pro tier(2026年夏予定): cross-device sync / チーム共有メモリ / Web ダッシュボード。$19/月(早期登録者価格)

関連