OMEGA Memory

OMEGA

AI エージェントのためのモデル横断型メモリ。ローカルファースト。Claude、GPT、Gemini、Cursor、Claw Code、あらゆる MCP クライアントで動作します。 エージェントの頭脳を他人のサーバーに置いたり、特定のプロバイダーに縛られたりするべきではありません。

課題

AI コーディングエージェントには状態がありません。新しいセッションは毎回ゼロから始まります。既存の「解決策」は、特定のモデルプロバイダーに縛るか、コードベースのコンテキストをクラウドに送信します。

• コンテキストの喪失。 エージェントはセッションをまたぐと、決定事項、好み、アーキテクチャ上の選択をすべて忘れてしまいます。開発者は、すでに確立されたコンテキストを説明し直すために、セッションごとに 10～30 分を費やしています。
• 同じ間違いの繰り返し。 過去のセッションから学習できないため、エージェントは同じミスを何度も繰り返します。何がうまくいき、何が失敗したのか、あるアプローチが選ばれた理由も記憶していません。
• クラウドメモリ＝他人のデータベース。 Mem0 のようなサービスでは API キーが必要で、データがサービスのサーバーに送信されます。料金が変更されたり、買収されたり、サービスが停止したりすると、エージェントが蓄積した知識は失われます。
• ベンダーロックイン。 Anthropic の Memory Tool は Claude でしか動作しません。OpenAI のメモリは GPT でしか動作しません。モデルを切り替えると、メモリを失います。

OMEGA はこれらの問題を解決します。メモリ、連携、学習をすべてお使いのマシン上で実行します。主要な LLM とコーディングエージェントすべてで動作します。クラウド不要。API キー不要。ベンダーロックインなし。

クイックインストール

OMEGA には Python 3.11 以降が必要です。python3 --version で確認してください。macOS に標準搭載されているのは古すぎる Python 3.9 です。pip が No matching distribution found for omega-memory と表示する場合は、それが原因です。まず新しい Python をインストールしてください（たとえば brew install [email protected]、または python.org からインストールします）。

OMEGA は専用の環境にインストールしてください。Homebrew の Python では pip install の直接実行が拒否され（PEP 668）、専用環境にインストールすれば OMEGA の依存関係がプロジェクトから分離されます。いずれかを選んでください：

# pipx
pipx install "omega-memory[server]"

# or uv
uv tool install "omega-memory[server]"

# or a virtual environment
python3.12 -m venv ~/.venvs/omega     # any Python 3.11 or newer
~/.venvs/omega/bin/pip install "omega-memory[server]"
export PATH="$HOME/.venvs/omega/bin:$PATH"

"omega-memory[server]" は引用符で囲んだままにしてください。macOS のデフォルトシェルである zsh は、引用符のない角括弧をパターンとして扱い、エラーになります。[server] エクストラを指定すると MCP サーバーがインストールされ、このサーバーはフックデーモンも実行します。これがないと、Claude Code では OMEGA のツールもフックも利用できません。

続いて：

omega setup     # downloads the embedding model, registers the MCP server, installs hooks
omega doctor    # checks every step, and names the fix for anything that failed

omega setup --dry-run を実行すると、ファイルへの書き込みやダウンロードを行わずに、セットアップで変更される内容を確認できます。

Claude Desktop

omega setup --client claude-desktop

これにより、Claude Desktop の設定に OMEGA が MCP サーバーとして登録されます。有効にするには Claude Desktop を再起動してください。

Cursor、Windsurf、Cline、Codex、Antigravity

omega setup --client cursor      # or: windsurf, cline, codex, antigravity

Codex と Antigravity では設定ファイルが書き込まれます。それ以外では、貼り付ける JSON ブロックが表示されます。ほかの MCP クライアントを使う場合は、omega setup --client venv を実行すると、使用するコマンドと引数が表示されます。フック（自動取得と表示）は Claude Code でのみ利用できます。

pip install omega-memory    # Core only, no MCP server

from omega import store, query, remember

store("Always use TypeScript strict mode", "user_preference")
results = query("TypeScript preferences")

ソースからのインストール

git clone https://github.com/omega-memory/omega-memory.git
cd omega-memory
python3.12 -m venv .venv && source .venv/bin/activate
pip install -e ".[server,dev]"
omega setup

omega setup は次の処理を行います：

1. ~/.omega/（または設定されている場合は $OMEGA_HOME）を作成します
2. ONNX 埋め込みモデル bge-small-en-v1.5（約 130 MB）とリランカー（約 90 MB）を ~/.cache/omega/models/ にダウンロードします
3. omega-memory を MCP サーバーとして登録します（Claude Code は自動検出されます。それ以外は --client を指定してください）
4. セッションフックを ~/.claude/settings.json にインストールします
5. ~/.claude/CLAUDE.md に OMEGA ブロックを追加します

いずれかの手順が失敗すると、サマリーに理由とともに [FAIL] と表示され、セットアップはエラーで終了します。

60秒で始める

OMEGA は自然言語で動作します。API 呼び出しも設定も不要です。Claude に話しかけるだけです。

1. Claude に何かを覚えておくよう伝えます：

「認証システムではセッション Cookie ではなく JWT トークンを使うことを覚えておいて」

Claude はこれをセマンティック埋め込みとともに永続的なメモリーとして保存します。

2. セッションを終了し、新しいセッションを開きます。

3. それについて質問します：

「認証について、どのように決めた？」

OMEGA は関連するメモリーを自動的に提示します：

Found 1 relevant memory:
  [decision] "The auth system uses JWT tokens, not session cookies"
  Stored 2 days ago | accessed 3 times

以上です。メモリーはセッションをまたいで保持され、時間とともに蓄積され、関連性があると自動的に提示されます。明示的に尋ねなくても提示されます。

主な機能

• メモリーと学習 — 決定事項、学んだこと、エラーパターン、設定をセマンティック検索とともに保存します。Claude は、毎回すべてを説明し直さなくても、重要なことを思い出します。ツールでは、コンパクション、統合、タイムライン、グラフ走査、チェックポイントと再開に対応しています。

• マルチエージェント連携 (omega-pro) — ファイルとブランチのロック、セッション管理、依存関係付きタスクキュー、インテントのブロードキャスト、エージェント間メッセージングにより、エージェント同士が互いの作業を上書きするのを防ぎます。

• インテリジェントな LLM ルーティング (omega-pro) — タスクを分類し、最適なモデルにルーティングします。コーディング → Claude Sonnet。簡単な編集 → コストが 1/60 の Llama 8b。100 万トークンのコンテキスト → Gemini Flash。5 つのプロバイダー、4 つの優先モード、2 ミリ秒未満のインテント分類に対応しています。

• ナレッジベース (omega-pro) — PDF、Markdown、ウェブページ、テキストファイルを、セマンティックチャンク化した検索可能なナレッジベースに取り込みます。

• エンティティレジストリ (omega-pro) — 関係、階層、エンティティごとのメモリー／プロファイル／ドキュメントを備えた、複数エンティティ対応の企業向けメモリーです。

• セキュアプロファイル (omega-pro) — macOS Keychain と統合された AES-256 暗号化個人データストレージです。

OMEGA の比較

Anthropic の Memory Tool はクライアント側にデータを保存しますが、すべてのメモリー操作で Claude API 呼び出しが必要です。OMEGA は埋め込み（ONNX）を含め、すべてをデバイス上で実行します。

Anthropic Memory は Anthropic 向けです。OMEGA はすべての人のためのものです。

アーキテクチャ

     Claude Code  ·  Cursor  ·  Claw Code  ·  Any MCP Client
               │         │         │              │
               └─────────┴─────┬───┴──────────────┘
                               │ stdio/MCP
               ┌───────────────▼─────────────┐
               │   OMEGA MCP Server   │
               │   core memory tools  │
               └──┬──────────────────┘
                  │
         ┌────────▼──────────────┐
         │ Core Memory Engine    │
         │ (semantic search,     │
         │  embeddings, graphs)  │
         └─────┬─────────────────┘
               │
               ▼
         ┌──────────────────────────────────────┐
         │         omega.db (SQLite)             │
         │  memories | edges | embeddings        │
         └──────────────────────────────────────┘

単一のデータベースとモジュール式ハンドラーを使用します。オプションモジュール（coordination、router、entity、knowledge、profile）は OMEGA Pro で利用でき、同じサーバープロセスに登録されます。個別のデーモンもマイクロサービスもありません。

MCP ツールのリファレンス

OMEGA は Claude Code 内で MCP サーバーとして動作します。デフォルトでは、コンテキストの節約のためにクライアントには 5 つのツール（omega_store、omega_welcome、omega_protocol、omega_tools、omega_call）が表示されます。omega_tools は利用可能なすべてのツールを一覧表示し、omega_call はそのいずれも実行します。すべてのツールを個別に表示するには、サーバーの環境に OMEGA_CONDENSED=0 を設定します。

コアツール

OMEGA Pro では、調整、ルーティング、エンティティ、ナレッジベース、プロフィールのツールが追加されます。

CLI

無料版と Pro 版

コア機能は無料のオープンソースです。無料プランでは、ストア内の記憶が 2,000 件に達すると、検索はセマンティック検索から単純なテキスト一致に切り替わり、5,000 件に達すると新しい記憶の保存が停止します。omega status で現在の状況を確認できます。OMEGA Pro では、どちらの上限もなくなります。

トラブルシューティング

omega doctor のインポート結果が FAIL になる場合：

• リポジトリのルートで pip install -e ".[server]" を実行してください
• python3 -c "import omega" が動作することを確認してください

MCP サーバーの起動に失敗する場合：

• OMEGA と同じ環境にサーバー追加機能をインストールしてください：pip install "omega-memory[server]"（または pipx install --force "omega-memory[server]"）

MCP サーバーが登録されていない場合：

• omega setup を再度実行するか、omega doctor が表示する claude mcp add -s user omega-memory -- ... コマンドを実行してください。このコマンドでは、OMEGA 自身の環境にある Python が指定されています

フックが実行されない場合：

• omega hooks doctor を実行してください。omega hooks setup で不足または古いエントリーを修復できます
• ~/.omega/hooks.log でエラーを確認してください

開発

pip install -e ".[server,dev]"
pytest tests/                # Test suite
ruff check src/              # Lint

アンインストール

claude mcp remove -s user omega-memory
omega serve uninstall        # only if you installed the HTTP daemon
rm -rf ~/.omega ~/.cache/omega
pipx uninstall omega-memory  # or: uv tool uninstall omega-memory, or delete the venv

~/.claude/settings.json から OMEGA のエントリーを手動で削除し、~/.claude/CLAUDE.md から `` ブロックを削除してください。

コントリビューション

• コントリビューションガイド
• セキュリティポリシー
• 変更履歴
• バグを報告

ライセンス

Apache-2.0。詳細は LICENSE を参照してください。