Aletheia

Aletheia

AI コーディングツール向けの、無料でローカルに使えるメモリとルールのハブです。
マシン上にストアをひとつ。あらゆるツールが MCP、REST、または CLI 経由で読み取れます。

インストールして実行してください。Bun 1.1 以降が必要です。CLI は Node ではなく Bun 上で動作します。

npm install -g aletheia-mem
aletheia-server
# open http://127.0.0.1:37790

ドキュメントサイト · フロントエンドガイド · 変更履歴 · 課題

ステータス：アルファ版。 メモリエンジンとインストーラーはテストで動作しています。実際の Claude Code、Command Code、Codex CLI、OpenCode では生成された MCP 設定が一覧表示されましたが、どのツールでもフックやセッションはまだ実行されておらず、回答の精度も測定されていません。CI は Linux と macOS で実行されます。Windows はまだサポートされておらず、テストもされていません。

1,414 件のテスト — 失敗 0 件（bun test を実行）。 English · 中文 · Español · Português (Brasil) · 日本語 · Deutsch · Français · 한국어 · हिन्दी · العربية · Русский。 機械翻訳は docs/i18n/ にあります。英語版が正式版です。どの翻訳もネイティブによるレビューを受けていません。

概要

Aletheia は、AI コーディングツール向けの無料のローカルメモリおよびルールハブです。1 つの SQLite ストアを、あらゆるツールから MCP、REST、または CLI 経由で読み取り、ルールは各ツール独自の指示ファイルに書き込みます。

すべてのコーディングエージェントはセッション間で内容を忘れ、それぞれ異なる方法で記憶します。Aletheia はメモリとルールを一度だけ、お使いのマシンに保存し、各ツールがすでに理解している形式で読み取れるようにします。アカウントもテレメトリもなく、モデルプロバイダーを設定しない限りネットワークへの通信もありません。ループバックのみで待ち受けます。

3 つのコマンドでインストール

git clone https://github.com/mohamed-ashraf-elsaed/aletheia-mem
cd aletheia-mem
bun bin/aletheia-server.mjs

http://127.0.0.1:37790 を開きます。Bun 1.1 以降が必要です。公開パッケージをインストールするには、代わりに npm install -g aletheia-mem を実行し、その後 aletheia-server で起動します。実行時にインストールが必要な依存関係はありません。

最初の画面には 4 つのタブがあります。Work（キャプチャしたセッション、事実、目標を表示する Aletheia 独自の画面）、Memory（検索、編集、ピン留め、削除、エクスポート）、Rules（一度書いて同期）、Tools（インストーラーの状態と監査）。

キャプチャの仕組み

aletheia install claude-code --write
aletheia install cursor --write
aletheia install --list          # capability level and verification per tool

--write を指定しない場合、コマンドはドライランとして実行されます。変更対象となるすべてのファイルを表示しますが、何も書き込みません。変更された各ファイルにはタイムスタンプ付きのバックアップが作成されます。フックはインストール済みの aletheia コマンドを呼び出し、保存前にシークレットと <private> ブロックを秘匿化します。データベースが利用できない場合はディスクに一時保存し、ホストをブロックしないよう常に終了コード 0 で終了します。圧縮はキューに登録され、フック内では実行されません。詳細とホストごとの正確なフック一覧については、docs/25 を参照してください。

接続できるツール

Aletheia は特定のツールに依存しません。MCP（stdio と HTTP）、プレーンな REST API、CLI に対応し、各ツールがすでに読み込む指示ファイルを書き込みます。確認済みの内容と未確認の内容は次のとおりです。

確認項目	結果
公式 MCP SDK クライアントを使用した MCP サーバー	合格（プロトコルバージョン 2025-11-25 から 2024-11-05）
Claude Code、Command Code、Cursor、Codex CLI、Gemini CLI、Windsurf、OpenCode の設定形式	2026-10-26 に取得した公式ドキュメントに基づいて作成し、フィクスチャでテスト済みです。2026-10-27 に実際の CLI で Claude Code、Command Code、Codex CLI、OpenCode の Aletheia MCP サーバーが一覧表示されました。Cursor、Gemini CLI、Windsurf は実際のインストール環境ではテストしていません。
Claude Desktop の MCP 設定	ドキュメント化し、フィクスチャに対してマージテスト済みです。アプリ内では開いていません
ルールファイル：CLAUDE.md、AGENTS.md、GEMINI.md、.cursor/rules/*.mdc、.windsurf/rules/*.md、Copilot、Aider	一時フォルダーで作成・テスト済みです（docs/verification/rules-targets.md）
上記のいずれかを該当ツールの実際のインストール環境で確認した結果	2026-10-27 に、実際の CLI で Claude Code、Command Code、Codex CLI、OpenCode の MCP 設定を読み戻して確認しました。いずれのツール内でもフックやセッションは実行していません。
ツールのフックによる自動キャプチャ	Claude Code、Command Code、Cursor、Codex CLI、Gemini CLI、Windsurf 向けに構築済みです。一時的な HOME で記録済みペイロードを使い、インストールされた各フックコマンドをエンドツーエンドで実行しています。ツール内で実行したものはありません。OpenCode は MCP＋ルールに対応します。

ツール	対応レベル	検証状況	インストールされるフックイベント
claude-code	full	2026-10-27 に MCP 接続を確認（2.1.312）。フックは未実行	SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd
command-code	full	2026-10-27 に MCP 接続を確認（1.88.1）。フックは未実行	SessionStart、PostToolUse、Stop
cursor	full	ドキュメントに基づいて設定を作成。実際のインストール環境では未テスト	sessionStart、beforeSubmitPrompt、postToolUse、afterAgentResponse、stop、sessionEnd
codex	full	2026-10-27 に MCP 接続を確認（0.130.0）。フックは未実行	SessionStart、UserPromptSubmit、PostToolUse、Stop、SessionEnd
gemini-cli	full	ドキュメントに基づいて設定を作成。実際のインストール環境では未テスト	SessionStart、BeforeAgent、AfterTool、AfterAgent、SessionEnd
windsurf	full	ドキュメントに基づいて設定を作成。実際のインストール環境では未テスト	pre_user_prompt、post_run_command、post_write_code、post_cascade_response
opencode	mcp+rules	2026-10-27 に MCP 接続を確認（1.18.33）。フックは未実行	なし（MCP とルールのみ）

src/hub/install.mjs から aletheia install --list を使って生成しました。MCP 接続と記載されている行は、実際の CLI でサーバーが一覧表示された場合に限ります。フックはどのツール内でも実行していません。

測定値

LoCoMo での claude-mem 15.2.0 の出荷時設定と、このプロジェクトとの比較です。これは検索の数値であり、回答の正確さではありません。

実行	質問数	Recall@5	MRR	クエリあたりの時間（ms）
claude-mem 15.2.0（出荷時設定）、生のターン — 当方による測定	1,536	36.0%	0.285	p50 1,699 ms、p95 2,824 ms（アイドル時、40 クエリ）
生のターン、全 10 会話	1,536	57.4%	0.497	3.72
データセットの事実、全 10 会話	1,536	64.8%	0.591	5.53
データセットの事実、3 会話	383	67.4%	0.620	5.80
データセットの事実、3 会話、＋再ランキング	383	73.9%	0.686	251.16
データセットの事実、全 10 会話、＋再ランキング	1,536	72.3%	0.680	646.19
当方のルールベース抽出による事実、全 10 会話	1,536	57.7%	0.492	4.94

検索のみ：Recall@5 は、正解の根拠が上位 5 件の結果に含まれているかを示します。回答の正確さではありません。すべての行は同じ LoCoMo の質問を使って当方が測定したもので、この表にベンダーが主張するベンチマーク値はありません。bench/results/2026-10-26/ から生成（bench/claude-mem-baseline.mjs、raw-turns.json（ハイブリッド）、dataset-facts.json（ハイブリッド＋事実）、dataset-facts-3-rerank.json（ハイブリッド＋事実）、dataset-facts-3-rerank.json（ハイブリッド＋事実＋再ランキング）、dataset-facts-rerank.json（ハイブリッド＋事実＋再ランキング）、our-facts-rules.json（ハイブリッド＋事実））。bun scripts/compare-bench.mjs で再実行できます。

表は次のように読み取ってください。

• Recall@5 は検索指標です。 正解の根拠が上位 5 件の結果に含まれているかを示します。回答が正しかったかどうかを判定するものではありません。
• 回答の正確さは測定していません。 読み手や判定者のハーネスはまだありません。
• 両方のシステムに同じ抽出済みの事実を与えた場合、差は 2 倍ではありません。 速度の差は品質の差より大きくなっています。
• 最初のローカル抽出は失敗しました。 Ollama の llama3.2:1b は簡単な呼び出しには応答しましたが、2 ターンのウィンドウに対する facts-v1 プロンプトは 4 分 41 秒後に HTTP 500 を返しました。この実行では事実を抽出できませんでした。
• 当方のルールベース抽出器では、事実による向上を再現できません。 1,672 件の事実を追加しましたが、Recall@5 は 57.3% から 57.7% へ移っただけです。データセット独自の事実では 7.3 ポイント向上しました。手法、元ファイル、否定的な結果については、bench/results を参照してください。

比較

機能	Aletheia（現在）	claude-mem	Mem0	Zep/Graphiti	Supermemory	Basic Memory
ローカル優先	はい	はい	はい（OSS）	一部（Graphiti のみ）	はい（セルフホスト）	はい
無料	はい	はい（OSS）	はい（OSS）	一部（Graphiti は無料）	はい（OSS）	はい（OSS）
アカウント不要	はい	はい（ローカル）	はい（OSS）	はい（Graphiti）	はい（セルフホスト）	はい
MCP	はい（stdio + HTTP）	はい	はい	一部（リファレンスサーバー）	はい	はい
REST	はい /v1	はい（worker API）	はい	はい	はい	一部
CLI	はい	はい npx	一部	いいえ	一部	はい
ルールをツールファイルに同期	はい（9 つのターゲット）	いいえ	いいえ	いいえ	いいえ	一部（AGENTS.md）
ツール間のインポート／エクスポート	一部（独自バンドル + claude-mem）	一部（エクスポート／インポート）	一部（プラットフォーム移行）	一部	一部	はい（Markdown）
フックによる取り込み	はい（6 つのホストでテスト済み、フィクスチャテスト済み。ホスト側は未公開）	はい	いいえ	いいえ	いいえ	一部
ベクトル検索	一部（オプションの ONNX）	はい（Chroma）	はい	はい	はい	はい
グラフ／エンティティメモリ	一部（エンティティ行が存在し、グラフ検索に対応）	いいえ	はい	はい	未検証	はい（ウィキリンク）
時間的推論	一部（生物時間的な事実、無効化、as-of クエリ）	一部（日付）	はい	はい	はい	一部
チーム共有	一部（セルフホスト型の同期とデバイス、チームモード）	一部（有料）	はい（有料）	はい（有料）	はい（有料）	いいえ
公開済みで再現可能なベンチマーク	一部（検索はあり、回答はなし）	いいえ	ベンダー提供のみ	ベンダー提供のみ	ベンダー提供のみ	いいえ
対応言語	11（英語 + 機械翻訳 10 種。ネイティブレビューなし）	29 のモード、README 32 件	SDK	SDK	SDK	SDK

競合製品のセルは、各プロジェクトの公開ドキュメントから取得した内容をそのまま記載しています。取得日は 2026-10-26 です。Aletheia のセルは、テスト済み機能に基づき 2026-10-26 に更新しました。インストーラーのソースは docs/25-installers.md にあります。ソースに記載のないセルは「未検証」としています。

同期とリモート MCP

どちらもセルフホスト型で無料ですが、実機 2 台間でのテストは行われていません。

• Aletheia Sync は、各操作に 1 つの結果を持つ追記専用の操作ログで、デバイスのペアリング、トゥームストーン、圧縮、パージ、スコープ付きトークンに対応しています。エンドツーエンド暗号化を有効にすると、ペイロードは送信前にデバイス上で暗号化されますが、デバイス ID、操作の種類、エンティティ ID、タイミング、暗号文のサイズなどのメタデータは隠されません。暗号化されていないアカウントでは、ハブ上にペイロードが平文で保存されます。ループバックのみでテスト済みです。docs/29
• Remote MCP は、MCP Streamable HTTP トランスポート経由で読み取りツールを提供します（sync または admin トークンを使用すると、書き込みツールも利用できます）。各呼び出しにはベアラートークンが必要で、レート制限が適用され、追記専用の監査行に記録されます。TLS はリバースプロキシまたはトンネルに委任されます。OAuth は組み込まれていません。docs/30

インターフェース

インターフェース	場所	用途
MCP（stdio）	bun bin/mcp.mjs	以下の 13 個の MCP ツール（読み取りと書き込み）
MCP（HTTP）	同期ハブ /mcp	ベアラートークンとトークンごとのスコープを使用する同じツール
REST	/v1/memories, /v1/search, /v1/timeline, /v1/observations/batch, /v1/context, /v1/events, /v1/info, /v1/work	スクリプト、CI、任意の言語。オプションで ALETHEIA_API_KEY ベアラーキーを使用
CLI	bin/aletheia.mjs	フック、シェル、cron、同期
ファイル	ルール同期	各ツール固有の指示ファイル

MCP ツール

ツール	目的	アクセス
search	共有メモリを検索します	読み取り
timeline	メモリ周辺のコンテキストを表示します	読み取り
get_observations	ID でメモリの全文を取得します	読み取り
save_memory	メモリを保存します	書き込み
session_start_context	セッション開始時のコンテキストを読み込みます	読み取り
fact_history	ファクトの変更履歴を表示します	読み取り
list_rules	適用中のルールを一覧表示します	読み取り
add_rule	適用中のルールを追加します	書き込み
confirm_rule	ルールが引き続き正しいことを確認します	書き込み
dismiss_memory	メモリを非表示にします	書き込み
restore_memory	非表示にしたメモリを復元します	書き込み
work_state_write	作業状態のリストを書き込みます	書き込み
work_state_read	作業状態のリストを読み込みます	読み取り

設定

すべての設定は環境変数で行います。デフォルト値は、単一ユーザーのマシンで安全に使える設定です。

変数	デフォルト	意味
ALETHEIA_PORT	37790	リッスンポートです。
ALETHEIA_HOST	127.0.0.1	バインドアドレスです。ループバック以外にバインドすると、Hub のログインが有効になります。
ALETHEIA_DATA_DIR	~/.aletheia	hub.db を含め、このプロジェクトが書き込むすべてのデータの保存先です。
ALETHEIA_HUB_DB	<data dir>/hub.db	共有メモリストアです。
ALETHEIA_API_KEY	empty	設定すると、/v1/* で必要になるベアラーキーです。
CLAUDE_MEM_DB	~/.claude-mem/claude-mem.db	claude-mem のデータベースです（読み取り専用。インポーターと任意のレガシービューアーが使用します）。
ALETHEIA_RULES_FILE	<data dir>/MY-RULES.md	レガシーの Work ビューで使用するルールファイルです。
ALETHEIA_PROVIDER	none	none、claude-cli、または OpenAI 互換プロバイダーです。
ALETHEIA_PROVIDERS	empty	優先順に並べたフォールバックチェーンです。例：ollama,openai。
ALETHEIA_OPENAI_BASE_URL, _API_KEY, _MODEL	OpenRouter URL, empty, empty	openai と人間によるコピーで使用します。
ALETHEIA_OUTPUT_LANGUAGE	empty	抽出されたファクトと要約に使用する言語です。
ALETHEIA_BUG_COMPAT	off	1 にすると、オリジナルの空の観測部分を再現します。
ALETHEIA_TOOL, ALETHEIA_CWD		MCP サーバー：呼び出し元のツールとデフォルトのプロジェクトを指定します。

制限と未検証の主張

このリストは、README の正直な側面を示しています。

• 実際の CLI で、2026-10-27 に Claude Code、Command Code、Codex CLI、OpenCode 向けの MCP 設定が一覧表示されましたが、ホスト内でフックもセッションも実行されていません。Cursor、Gemini CLI、Windsurf は引き続き「ドキュメントをもとに設定を書いただけで、実環境では未テスト」です。
• CI は Linux と macOS で実行されます。ベンチマークは Linux でのみ実行されます。Windows はまだサポートされておらず、テストもされていません。
• 回答の正確性は測定されていません。Recall@5 は検索の指標であり、回答が正しかったかどうかを示すものではありません。
• 1B モデルによる抽出の実行は失敗しました。当社独自の抽出器によるファクトは、ルール抽出器のみで測定されています。
• 同期と E2EE は、一時データディレクトリとループバックの Hub でテストされています。実際のトンネルや別のホストは使用されていません。
• E2EE が保護するのはペイロードであり、メタデータは対象外です。
• 合成した 50,000 行では、キーワード検索の p95 はプロジェクト単位で 32.7 ms、全プロジェクト横断で 58.6 ms です（当社による測定：bun bench/scale.mjs 50000 20000 --index tuned --queries 200 --seed 1、Linux）。プロジェクト単位の検索では、50 ms の目標を達成しています。
• README の翻訳 10 件は機械翻訳です。ネイティブスピーカーによるレビューは受けていません。
• どのツールについても「 で動作する」とは主張していません。そう主張するには、実際のインストール環境でのテストが必要です。

構成

bin/            server, CLI, MCP server, sync hub, legacy Work ledger CLI
src/
  server.mjs app.mjs source.mjs config.mjs humancopy.mjs      server and the legacy Work API
  readmodel/ ledger/ refresh/ store/ http/                     legacy Work internals
  hub/            store (memories, FTS5, rules, bundles)  rules-sync  tools  importers  capture  compress  mcp  routes  sync
public/         the one UI (index.html, one-ui.*, tabs/, work-view.js);
                work.html and assets/ are the optional legacy viewer
public-hub/     the old Memory Hub assets, still served at /hub/app.js
prompts/ vendor/ the original's skill prompts and Python scripts
test/           the test suite and a synthetic fixture database
docs/           the documents

ドキュメント

1. アーキテクチャ · データモデル · HTTP API · フロントエンド · 運用
2. インストーラー · 同期 · リモート MCP · チームモード · リクエストと目標
3. 依存関係とライセンス · Claude Desktop · ルールの対象

貢献

最も役立つ貢献は、実際にインストールして試した結果の報告です。ツール名、バージョン、実行したコマンド、ツールの動作を記載して、Issueを作成してください。CONTRIBUTING.mdをご覧ください。プルリクエストを送る前に、bun testとbun scripts/gen-tables.mjs --checkを実行してください。新しいランタイム依存関係を追加する場合は、その理由が必要です。

ライセンス

Apache-2.0です。claude-memに由来する内容については、NOTICE.mdをご覧ください。claude-memの作者またはAnthropicとは提携しておらず、推薦も受けていません。