# OpenMem

> OpenMem is a memory interface for coding agents — one memory_* API, wizard, and indexer over pluggable providers (Hindsight, mem0, Cognee, …).

Source: https://github.com/bcmyguest/openmem

## Docs

- [Concepts](https://bcmyguest.github.io/openmem/docs/concepts.md): OpenMem as a memory interface for coding agents — providers, memory_* API, banks, and formats.
- [Quickstart](https://bcmyguest.github.io/openmem/docs/getting-started.md): Run the wizard once (npx or git checkout), verify health, optional MCP install.
- [Installing with npx](https://bcmyguest.github.io/openmem/docs/npx-install.md): Install and run the openmem wizard through npx.
- [Architecture](https://bcmyguest.github.io/openmem/docs/architecture.md): Runtime data flow, how changes update memory, and MCP access per provider.
- [MCP setup](https://bcmyguest.github.io/openmem/docs/mcp-setup.md): Install unified memory_* MCP, optional provider-native servers, and NotebookLM.
- [Provider status](https://bcmyguest.github.io/openmem/docs/provider-status.md): Every provider, its status, and its self-host story, generated from the provider manifests.
- [Hindsight](https://bcmyguest.github.io/openmem/docs/hindsight.md): Default Compose stack, LiteLLM, loopback API, session hooks, and optional plugin.
- [Model configuration](https://bcmyguest.github.io/openmem/docs/model-configuration.md): LiteLLM aliases and backends for Hindsight retain, reflect, and consolidate.
- [mem0](https://bcmyguest.github.io/openmem/docs/mem0.md): Self-hosted mem0 REST with OpenMem indexer, unified memory_* MCP, and PMM portability.
- [Cognee](https://bcmyguest.github.io/openmem/docs/cognee.md): Loopback Cognee container, REST ingest, and read-only MCP tools.
- [Portable memory (PMM)](https://bcmyguest.github.io/openmem/docs/memory-portability.md): PMM export/import format and unified MCP memory_export / memory_import behavior.
- [Configuration file](https://bcmyguest.github.io/openmem/docs/openmem-config.md): The mise-like config.toml: files, precedence, sections, and the pm tasks.
- [Index sources](https://bcmyguest.github.io/openmem/docs/index-sources.md): Git, Obsidian, notes, papers, bookmarks, and feed cache banks for the shared indexer.
- [Feed sync](https://bcmyguest.github.io/openmem/docs/sources-feeds.md): RSS and OpenAlex queries into a watched markdown cache for feed::* banks.
- [Zotero exports](https://bcmyguest.github.io/openmem/docs/sources-zotero.md): Point papers.paths at Zotero markdown export folders.
- [Readwise exports](https://bcmyguest.github.io/openmem/docs/sources-readwise.md): Readwise markdown export directories as notes or papers sources.

## Providers

Generated from providers/*/manifest.json at build time.

- Cognee (cognee): Supported. Docker Compose services: cognee, indexer. Default host port 8766 (COGNEE_PORT).
- Hindsight (hindsight): Supported. Docker Compose services: litellm, hindsight, indexer. Default host port 8888 (HINDSIGHT_PORT).
- mem0 (mem0): Supported. Docker Compose services: indexer. Default host port 18888 (MEM0_PORT).
- Graphiti (graphiti): Planned. Not wired yet: no compose services declared.
- Letta (letta): Planned. Not wired yet: no compose services declared.
- Zep (zep): Planned. Not wired yet: no compose services declared.

## Works today

- Interactive and non-interactive wizard: configure, start, stop, --yes, --dry-run
- Provider manifests drive this site: supported today: Cognee, Hindsight, mem0
- Hindsight stack through Docker Compose, with a LiteLLM proxy in front of lemond, Ollama, or a custom endpoint
- mem0 (URL-only) and Cognee (pinned Docker image) compose profiles with provider wizard hooks and indexer sinks
- Indexer for git repositories and Obsidian vaults, with tree-sitter outlines and secret-path masking
- Smoke retain and recall, and an idempotent rerun that reports changed=N
- Declarative config.toml and npx @bcmyguest/openmem tasks: up, down, doctor, install-mcp, switch
- Unified openmem MCP (memory_add/search/recall/forget, PMM export/import) via install-mcp
- Opt-in NotebookLM sync; install-mcp also registers the NotebookLM MCP when enabled
- Provider-native MCP (mem0/Cognee) still available with install-mcp --provider-only

## Up next

- PMM import: mem0 duplicate detection; richer Cognee export (full document text)
- Graphiti: manifest status is planned
- Letta: manifest status is planned
- Zep: manifest status is planned
- Live end-to-end runs against real mem0 and Cognee servers (required before supported)
- Further npm releases

## Optional

- [Full docs in one file](https://bcmyguest.github.io/openmem/llms-full.txt)