はじめに

HMG とは

HMG（Holographic Memory Graph）は AI Agent のための長期記憶システムです。Codex、Cursor、Claude Code などのコーディングアシスタントがセッションの境界を越えて記憶できるようにします：

従来のコーディングアシスタントは毎セッションゼロから始まり、プロジェクトの背景や「なぜこう書いたのか」を何度も説明し直す必要がありました。HMG は「将来役に立つ情報」を構造化された記憶として蓄え、正しいコンテキスト（プロジェクト、リポジトリ、ブランチ）で必要なときに取り出せるようにします：

HMG は完全にローカルで動作します：記憶データ、インデックス、埋め込みモデルはすべてマシン内に保存され、第三者のサービスを経由することはありません。

HMG は記憶データをローカルマシンに保存します。個人開発者や小規模なローカル利用に適しています。よくある場面：

場面	説明
個人開発の記憶	自分のプロジェクトの規約、踏んだ坑、ある方案を選んだ理由
プロジェクト規約	コードスタイル、テストコマンド、デプロイ制約、ディレクトリ規則
アーキテクチャ決定	なぜ A で B ではないか、代替案、リスク、検証結果
トラブルシューティング経験	根本原因は何か、何を試し、最終的にどう直したか
ユーザーの好み	安定したコーディングの好み（例：「常にスペースでインデント」「テストは vitest」）
タスク引き継ぎ	複数日にわたるタスクをセッション越えて継続。再開時にどこまでやったか、次は何かが分かる
マルチブランチの背景	feature ブランチの実験結論が main の安定した決定を汚染しない

注意：HMG の記憶はチャット履歴のダンプではなく、「今後再利用する情報」です。一時的な出力、完全なログ、一回限りの指示は長期記憶にすべきではありません。詳しくは記憶を参照。

インストール後、必要な手順は 2 つだけです：

bash
hmg setup
hmg init --agent codex

codex は cursor や claude に置き換えられます。統合後は：

セッション開始時、Agent は自動的に記憶ブリーフ（前回の引き継ぎ、重要な決定、リスク、次の一歩）を受け取ります
毎ターン、あなたのメッセージで関連記憶が先取り検索されます
スコープは自動分離：プロジェクト / リポジトリ / ブランチはセッションのディレクトリから機械的に推論・注入され、Agent は渡す必要がなく、間違えることもありません
書き込みは完全に自律：Agent は決定が行われたタイミングで memorize を呼び、タスク終了時に handoff を書きます

これで Agent は長期記憶を持ちます。同じプロジェクトで長く使うほど、あなたのコードベース、規約、好みへの理解が深まります。

開発者版の機能とより大きな記憶容量を利用するには、まず公式サイトでプランをアップグレードし、ローカルで hmg login を実行します（任意、ネットワークが必要）。ホストごとの違い、hooks、MCP 設定、手動接続については統合を参照してください。