Mom

Your AI assistant forgets everything between sessions. You re-explain decisions, conventions, architecture — every time. MOM fixes that.

MOM (Memory Oriented Machine) is an open-source CLI that gives AI agents persistent, structured memory. Decisions, constraints, patterns, and learnings — stored in your project, loaded automatically, evolving with every session. Harness-agnostic. On-prem. Schema-validated.

Self-hosting since v0.2 — MOM builds itself with its own memory.

Quick Start

# Install via Homebrew
brew tap momhq/tap
brew install mom

# Update
brew update && brew upgrade mom

# Or build from source
git clone https://github.com/momhq/mom.git
cd mom/cli && make install

# Initialize in your project
cd your-project
mom init

# Done. Your agent now has persistent memory.

How It Works

MOM creates a .mom/ directory in your project — a structured memory layer your AI agent loads at every session.

your-project/
├── .mom/                           # MOM's home
│   ├── config.yaml                 # preferences (language, communication mode)
│   ├── schema.json                 # document schema (v2)
│   ├── identity.json               # project identity
│   ├── memory/                     # memory documents (structured JSON)
│   ├── constraints/                # always-active guardrails
│   ├── skills/                     # composable procedures
│   ├── raw/                        # continuous session capture (JSONL)
│   ├── logs/                       # session logs
│   └── cache/
│
├── .mcp.json                       # MCP server config (auto-injected)
├── .claude/CLAUDE.md               # auto-generated boot file for Claude Code
└── your code...

You work with your agent. MOM validates, indexes, and delivers memory to the harness. Switch harnesses without losing anything.

What Makes It Different

Memory compounds. Month 6 is structurally richer than month 1. Your agent knows the web of decisions behind your codebase. No one starting from zero can match months of accumulated context.

Harness-agnostic. Memory lives in .mom/, not in .claude/ or .cursor/. MOM generates the right context for each harness through adapters. Your memory is yours, not locked to a vendor.

Schema-validated. Every memory document is tagged, scoped, and promotion-managed. Not a loose Markdown file — a structured, queryable memory with free-form content.

MCP-first. MOM delivers context via Model Context Protocol. Agents search, read, and write memory through MCP tools — no file parsing, no guesswork. .mcp.json is auto-injected on mom init.

On-prem by default. Your memory stays in your repo. No cloud dependency. No data leaving your machine.

Commands

Supported Harnesses

Current Status

MOM is in active development (v0.14). It works, and it self-hosts — the tool builds itself with its own memory.

What's in v0.14:

• Progressive recall engine — searches repo → org → user, curated-first, AND→OR query relaxation when results are sparse
• Cleaner MCP surface — mom_recall is the single retrieval tool, wired through the recall engine with optional scope pinning
• Harness tier system — Native / Fluent / Functional classification per harness, surfaced in mom doctor
• Pi support (Native tier) — TypeScript extension, .mcp.json registration, full watcher integration
• Constraints simplified — audited from 6 to 2: anti-hallucination and escalation-triggers
• session-wrap-up redesigned — surfaces drafts from disk via mom_recall, not from context window
• mom init as config manager — reconciles harnesses on reinit (enable new, disable removed)
• harness rename — runtime → harness throughout config, CLI flags, and internals
• SQLite FTS5 search with content-first column weights
• Global watch daemon (launchd / systemd) for all registered projects
• Multi-repo support with scope-based memory (repo → org → user)
• Homebrew installation with automated tap updates

Contributing

See CONTRIBUTING.md for setup, conventions, and how to submit PRs.

If you work with AI agents and feel the amnesia pain — issues, feedback, and honest criticism are welcome.

License

Apache 2.0