Omega Memory

Cross-model memory for AI agents. Local-first. Works with Claude, GPT, Gemini, Cursor, Claw Code, and any MCP client.Your agent's brain shouldn't live on someone else's server, or be locked to one provider.

AI coding agents are stateless. Every new session starts from zero. The "solutions" either lock you into one model provider or send your codebase context to their cloud.

- Context loss.Agents forget every decision, preference, and architectural choice between sessions. Developers spend 10-30 minutes per session re-explaining context that was already established.
- Repeated mistakes.Without learning from past sessions, agents make the same errors over and over. They don't remember what worked, what failed, or why a particular approach was chosen.
- Cloud memory = someone else's database.Services like Mem0 require API keys and send your data to their servers. When they change pricing, get acquired, or go down, your agent's accumulated intelligence disappears.
- Vendor lock-in.Anthropic's Memory Tool only works with Claude. OpenAI's memory only works with GPT. Switch models, lose your memory.

OMEGA solves this. Memory, coordination, and learning that runs entirely on your machine. Works with every major LLM and coding agent. No cloud. No API keys. No vendor lock-in.

pip install omega-memory[server] # Full install (memory + MCP server) omega setup # Downloads model, registers MCP, installs hooks omega doctor # Verify everything works

pip install omega-memory[server] omega setup --client claude-desktop

This registers OMEGA as an MCP server in Claude Desktop's config. Restart Claude Desktop to activate.

Cursor, Claw Code, Windsurf, Cline, Codex

pip install omega-memory[server] omega setup --client cursor # or: claw-code, windsurf, cline, codex

If you only need OMEGA as a Python library for scripts, CI/CD, or automation:

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

from omega import store, query, remember store("Always use TypeScript strict mode", "user_preference") results = query("TypeScript preferences")

This gives you the full storage and retrieval API without running an MCP server (~50 MB lighter, no background process). Hooks still work:

omega setup --hooks-only # Auto-capture + memory surfacing, no MCP server (~600MB RAM saved)

git clone https://github.com/omega-memory/omega.git cd omega pip install -e ".[server,dev]" omega setup

- Create~/.omega/directory
- Download the ONNX embedding model (~90 MB) to~/.cache/omega/models/
- Registeromega-memoryas an MCP server (Claude Code auto-detected, or specify --client)
- Install session hooks into~/.claude/settings.json
- Add an OMEGA block to~/.claude/CLAUDE.md

OMEGA works through natural language — no API calls, no configuration. Just talk to Claude.

Claude stores this as a permanent memory with semantic embeddings.

"What did I decide about authentication?"

OMEGA surfaces the relevant memory automatically:

That's it. Memories persist across sessions, accumulate over time, and are surfaced automatically when relevant — even if you don't explicitly ask.

-

Memory & Learning— Stores decisions, lessons, error patterns, and preferences with semantic search. Claude recalls what matters without you re-explaining everything each session. 25 memory tools including compaction, consolidation, timeline, graph traversal, and context virtualization (checkpoint/resume).

Multi-Agent Coordination(omega-pro)— File and branch locking, session management, task queues with dependencies, intent broadcasting, and agent-to-agent messaging. 29 coordination tools that prevent agents from overwriting each other's work.

Intelligent LLM Routing(omega-pro)— Classifies tasks and routes to the optimal model. Coding → Claude Sonnet. Quick edit → Llama 8b at 1/60th the cost. 1M token context → Gemini Flash. 5 providers, 4 priority modes, sub-2ms intent classification.

Knowledge Base(omega-pro)— Ingest PDFs, markdown, web pages, and text files into a searchable knowledge base with semantic chunking.

Entity Registry(omega-pro)— Multi-entity corporate memory with relationships, hierarchies, and entity-scoped memories/profiles/documents.

Secure Profile(omega-pro)— AES-256 encrypted personal data storage with macOS Keychain integration.

Anthropic's Memory Tool stores data client-side but requires Claude API calls for all memory operations. OMEGA runs entirely on-device, including embeddings (ONNX).

Anthropic Memory is for Anthropic. OMEGA is for everyone.

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

Single database, modular handlers. Optional modules (coordination, router, entity, knowledge, profile) are available viaomega-proand register into the same server process. No separate daemons, no microservices.

OMEGA runs as an MCP server inside Claude Code. The core package provides 25 memory tools.omega-proadds coordination, routing, entity, knowledge, and profile tools.

- Ensurepip install -e ".[server]"from the repo root
- Checkpython3 -c "import omega"works

- Runpip install omega-memory[server](the[server]extra includes the MCP package)

claude mcp add omega-memory -- python3 -m omega.server.mcp_server

- Check~/.claude/settings.jsonhas OMEGA hook entries
- Check~/.omega/hooks.logfor errors

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

claude mcp remove omega-memory rm -rf ~/.omega ~/.cache/omega pip uninstall omega-memory

Manually remove OMEGA entries from~/.claude/settings.jsonand the<!-- OMEGA:BEGIN -->block from~/.claude/CLAUDE.md.

- Contributing Guide
- Security Policy
- Changelog
- Report a Bug

MCP server for Christian scholarship and research — scripture, Greek/Hebrew word data, cross-references, patristic texts, and semantic search,