Hicortex — AI Fleet Memory

Hicortex — AI フリートメモリ

AI エージェントのための共有メモリ — 夜間に自ら修正し、あるエージェントが学んだことをフリート全体が知っています。 あらゆるエージェント、プロジェクト、マシンで共有するひとつのメモリにより、エージェントは推測をやめ、知識に基づいて行動できるようになります。

• ひとつの脳を、あらゆるハーネスで — Claude Code、Hermes、OpenClaw、Pi、OpenCode、およびあらゆる MCP 互換エージェントが同じメモリを共有します。
• 引き出すのではなく、届ける — サポート対象のすべてのコーディングエージェントで、コンパクトな想起インデックスがすべてのプロンプトに挿入されるため、エージェントが必要とする判断、修正、コンテキストがあらかじめ提示されます。説明の繰り返しも、コピー＆ペーストも、メンテナンスも不要です。1ターンあたりの LLM 呼び出しはゼロ — 想起による API コストやレート制限への影響はありません。
• 夜間に統合 — 毎晩、その日のセッションを読み込み、重要な情報を抽出して、学習事項、リンク、ナレッジグラフにまとめます。
• ローカルファースト — 生のセッションがマシンの外に出ることはなく、保存されるのは抽出されたメモリだけです。

インストール

npx @gamaze/hicortex init
Claude Desktop: one "yes" during init.

環境を自動検出し、LLM をひとつ設定し（Ollama、Claude CLI、または API キー）、ローカルデーモン（macOS では launchd、Linux では systemd）をインストールして、MCP ツールを Claude Code に登録します。

複数マシン構成では、シンクライアントを共有サーバーに接続できます。クライアント側にローカル DB や LLM は不要です。

npx @gamaze/hicortex init --server https://your-server.example.com

init はほかのハーネスも自動検出して、クライアントをインストールします。Pi 拡張機能（~/.pi/agent/extensions/hicortex.ts — プッシュ型の想起、アイデンティティと学習事項、10 個のツール。手動で配置する場合は pi-extension/hicortex/index.ts をコピー）、OpenCode プラグイン（~/.config/opencode/plugins/hicortex.ts — 同じ3機能。手動で配置する場合は opencode-plugin/hicortex/index.ts をコピー）、Hermes プラグイン、OpenClaw プラグインが含まれます。pi-mcp-adapter は、あらゆるハーネスで使える汎用 MCP の代替手段として引き続き利用できます（SSE エンドポイントで検証済み）。Pi ではもう必要ありません。詳しくはインストールガイドをご覧ください。

仕組み

CAPTURE (nightly)        CONSOLIDATE (nightly)             RECALL (every prompt)
sessions → denoise       score · reflect · link            a compact index of
→ POST /distill          decay · dedup · supersede         relevant memories is
                         (one model, all phases)           pushed into the prompt
                                                           → full text lazy-loaded

エージェントが使うメモリは強化され、使わないメモリは薄れていきます。また、関連するメモリ同士は自動的にリンクされます。検索には BM25 とベクトル検索を組み合わせたハイブリッド方式を採用しており、クエリ時の LLM 呼び出しはゼロです。

初回の夜間実行では、デフォルトで直近7日分のセッションを取り込みます（履歴全体ではありません）。さらに取り込むには、hicortex nightly --recapture-window <days> を一度実行してください。

特長

• プロンプトごとのリコールプッシュ — 関連するメモリが毎ターン、コンテキストに追加されます。エージェントは必要なときにのみ hicortex_get で全内容を取得します。
• /dashboard のメモリアナリティクス — 増加状況、リコールの活用状況、学習内容の夜間ダイジェストを確認できます。
• /viz のナレッジグラフ — メモリがドメインごとにクラスタ化され、関連性を示すエッジでつながります。
• ドメインとタグ — 設定可能な語彙による複数タグ分類に対応し、データに応じてカテゴリが変化します。
• リフレクションによる学習内容 — 夜間のリフレクションで、経験ログだけでなく、汎用的で再利用可能な学習内容を抽出します。
• 自己修正ストア — 毎晩、古くなった事実を日付付きの出典情報とともに上書きします。ほぼ重複する項目は1つにまとめられます（逐語的なコピーはそのまま保持され、無料で、統合は復元可能です）。置き換えられた決定事項は優先度を下げ、再び提示されることはありません。ゾンビメモリはありません。
• 求められなくても使われる設計 — コーディングエージェントにはフック経由でリコールが挿入され、指示に対応したクライアント（Claude Desktop、Cursorクラス）には常設の指示が与えられるため、頼まれなくてもメモリが使われます。通常のMCPクライアントでは、すべての検索機能を利用できます。
• 自己調整機能 — リコール、減衰、統合のしきい値について、それぞれの統計情報を報告します。調整は推測ではなく、測定に基づいて行われます。
• 常設コンテキストレイヤー — 手動編集できる「あなたについて／作業方法」のMarkdownを毎回のセッションに挿入し、減衰させずに保持します。

MCP

9つのMCPツール — hicortex_search、hicortex_get、hicortex_recent、hicortex_ingest、hicortex_lessons、hicortex_index、hicortex_graph、hicortex_update、hicortex_delete — と、学習内容を明示的に保存するための/learnスキルを提供します。全リファレンス →

スタック

TypeScript · Node.js 20+ · SQLite + sqlite-vec + FTS5（1つのDBでセマンティック検索と全文検索に対応）· ONNXエンベディング（bge-small-en、CPU）· HTTP/SSE経由のMCP · 設定可能なLLMを1つ（Ollama、Claude CLI、またはOpenAI互換のエンドポイント）

開発

git clone https://github.com/gamaze-labs/hicortex.git
cd hicortex

リポジトリのルートにあるAGENTS.mdで、機械的に検証できる検証要件を定義しています。「完了」とは、コマンドチェーン全体が終了コード0で終了することを意味します。この要件はCIの実行内容を反映しています。人間かエージェントかを問わず、コントリビューターは作業の完了を宣言する前にこれを実行してください。

コントリビューションを歓迎します。CONTRIBUTING.mdをご覧ください。

リンク

• ウェブサイト： hicortex.gamaze.com
• ドキュメント： hicortex.gamaze.com/docs
• 変更履歴： CHANGELOG.md
• npm： @gamaze/hicortex
• 課題： gamaze-labs/hicortex/issues
• セキュリティ： SECURITY.md

ライセンス

個人利用および非営利目的での利用は、PolyForm Noncommercial License 1.0.0に基づき無料です。商用利用にはユーザーごとのライセンスが必要です。詳しくはhicortex.gamaze.comをご覧ください。