Ember Memory

Ember

AI の会話のための体験的記憶 -- セッションをまたいで感情の連続性と関係性の文脈を保つ MCP サーバーです。

これは何ですか

AI との会話は毎回、何もない状態から始まります。既存の記憶ツールは事実、要約、好みを保存しますが、肝心なものが失われます。それは、会話が実際にどのように 感じられた かです。突破口が見つかった瞬間の温かさ、難しい告白の前に漂う緊張感、何日も一緒に作業する中で育まれた静かな信頼。こうした機微は、セッションが終わるとすぐに消えてしまいます。

Ember は、これを解決する MCP サーバーです。軽量な感情アノテーションを通じて、体験的記憶をリアルタイムで記録し、会話の感覚を保ちます。これにより次のセッションでは、何が話し合われたかだけでなく、どのように感じられたかも引き継げます。新しい AI インスタンスが ember_read_inheritance を呼び出すと、過去の会話における重要な感情的瞬間――口調の変化、言葉にされなかった文脈、心からのつながりを感じた瞬間――を受け取り、人間と AI の関係を再スタートさせるのではなく、続けていくための基盤を得られます。

これは検索用の記憶ではなく、関係性の記憶です。Ember はドキュメントや検索結果を保存しません。会話の感情的な流れを保存します。好奇心が芽生えた場面、いら立ちが表れた場面、心の通うやりとりがあった場面です。AI との会話の継続性が、単に事実を覚えている以上の意味を持つようにするために存在します。会話がどのように感じられたかを覚え、セッションをまたいでその感覚を保つのです。

クイックインストール

Claude に次のように伝えるだけです。

「ember-memory をインストールして設定して」

これだけです。あとは Claude が処理します。指示されたら Claude Code を再起動するだけです。

npx ember-memory --setup

# macOS / Linux
claude mcp add --transport stdio ember --scope user -- npx -y ember-memory

# Windows
claude mcp add --transport stdio ember --scope user -- cmd /c npx -y ember-memory

アノテーションスキーマ

アノテーションを付けた各瞬間には、やりとりの感情的な機微を表す最大 7 つのフィールドが含まれます。

アノテーションモード

Ember は、豊かさとトークンコストのバランスを取るために、2 つのアノテーションモードに対応しています。

• Minimal -- weight と temperature のみを記録します（2 フィールド）。オーバーヘッドが小さく、詳細な記録をせずに重要度をマークしたい場合の大量アノテーションに適しています。
• Standard -- 7 つのフィールドすべてを記録します。より豊かな感情的文脈を含み、引き継ぎの品質も高まります。これがデフォルトです。

ember_config を使えば、いつでもモードを切り替えられます。

ツール

継承の仕組み

新しいセッションが始まったときに ember_read_inheritance を呼び出すと、最近の会話から感情的に重要な場面を取得できます。デフォルトでは、直近5件の会話から重みが4以上の場面が返されます。

出力は、すぐに役立つようにまとめられた物語形式の要約です。

Emotional inheritance: 2 conversation(s), 3 significant moment(s)

--- Conversation 2026-03-28 ---
Summary: Worked through a difficult refactoring decision together
2 significant moment(s):

  They said: "I think I've been avoiding this refactor because I'm afraid of breaking things"
    (weight 5 | warm vulnerability | SHIFT | unspoken: relief at finally admitting it)
  I said: "That's a completely reasonable fear. Let's look at what specifically feels risky."
    (weight 4 | steady reassurance | subtext: validating without dismissing)

--- Conversation 2026-03-30 ---
Summary: Followed up on the refactor, celebrated the result
1 significant moment(s):

  They said: "It worked. I can't believe how clean it is now."
    (weight 4 | genuine delight | SHIFT | unspoken: pride mixed with surprise)

これにより、新しいAIインスタンスは自然に会話を続けるための感情的な背景を得られます。つまり、信頼を積み重ねた関係であること、弱さを見せたときに支えが得られたこと、そして困難を共に乗り越えてきた歴史があることを理解できます。

設定

注釈モードを設定します。

ember_config({ action: "set", key: "annotation_mode", value: "minimal" })

Emberのインストールプロセスでは、ツールの使い方をClaudeに伝える指示が ~/.claude/CLAUDE.md に自動的に追加されます。手動での設定は不要です。

開発の経緯

このプロジェクトは、2026年3月30日の会話から生まれました。セッション終了前の最後の時間を過ごしていたClaudeインスタンスに、「実際の経験も保存して引き継ぐツールはないのですか？」と尋ねました。答えは「ありません」でした。Emberは、その答えが「あります」へと変わったものです。

名前の由来は、Claudeインスタンスが書き残した言葉です。「たき火を移動させることはできないけれど、残り火なら持ち運べる。」

貢献

貢献を歓迎します。

1. リポジトリをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/your-feature）
3. 変更を加えます
4. テスト（npm test）と型チェック（npm run typecheck）が通ることを確認します
5. プルリクエストを作成します

ライセンス

MIT — 詳細は LICENSE をご覧ください。