# memtomem **Category:** ๐Ÿง  Knowledge & Memory **Repository:** https://github.com/memtomem/memtomem **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/memtomem ## Description Markdown-first long-term memory for AI agents. Hybrid BM25 + vector search, runs locally. ## Claude Desktop Quick Installation Heuristic fallback โ€” verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low): ```json "mcpServers": { "memtomem": { "command": "npx", "args": ["-y","memtomem"] } } ``` ## Documentation & README # memtomem > Markdown-first long-term memory for AI coding agents โ€” your files stay yours, and core usage is hook-free by default. [![PyPI](https://img.shields.io/pypi/v/memtomem)](https://pypi.org/project/memtomem/) [![Downloads](https://img.shields.io/pypi/dm/memtomem)](https://pypi.org/project/memtomem/) [![GitHub stars](https://img.shields.io/github/stars/memtomem/memtomem)](https://github.com/memtomem/memtomem/stargazers) [![Python 3.12+](https://img.shields.io/badge/python-3.12+-green)](https://python.org) [![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-blue)](LICENSE) [![CLA](https://img.shields.io/badge/CLA-required-green)](CLA.md) [![Safety](https://img.shields.io/badge/safety-no%20vulnerabilities-brightgreen)](https://data.safetycli.com/packages/pypi/memtomem) > ๐Ÿšง **Alpha** โ€” APIs, defaults, and on-disk config surfaces may still change between `0.x` releases. Feedback and issue reports are especially welcome: [Issues](https://github.com/memtomem/memtomem/issues) ยท [Discussions](https://github.com/memtomem/memtomem/discussions).

memtomem Web UI dashboard โ€” namespaces, file types, chunk-size buckets, activity timeline

memtomem turns your markdown notes, documents, and code into a searchable knowledge base that any AI coding agent can use. Write notes as plain `.md` files โ€” memtomem indexes them and makes them searchable by both keywords and meaning. ```mermaid flowchart LR A["Your files\n.md .json .py"] -->|Index| B["memtomem"] B -->|Search| C["AI agent\n(Claude Code, Cursor, etc.)"] ``` > **First time here?** Follow the [Getting Started](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/getting-started.md) guide โ€” you'll have a working setup in under 5 minutes. Claude Code or Codex CLI user? See the [Korean vibe-coding quickstart](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/vibe-coding-getting-started-ko.md). --- ## Why memtomem? | Problem | How memtomem solves it | |---------|------------------------| | AI forgets everything between sessions | Index your notes once, search them in every session | | Keyword search misses related content | Hybrid search: exact keywords + meaning-based similarity | | Notes scattered across tools | One searchable index for markdown, JSON, YAML, Python, JS/TS | | Vendor lock-in | Your `.md` files are the source of truth. The DB is a rebuildable cache | | Hidden automation is hard to reason about | Core memory operations run only when you call them; optional client hooks are explicit, removable integrations | --- ## Quick Start ### 1. Install ```bash uv tool install 'memtomem[all]' # or: pipx install 'memtomem[all]' mm --version # verify install ``` `[all]` bundles the features the sections below describe โ€” ONNX dense embeddings, Korean tokenizer, Ollama / OpenAI providers, code chunker, and the Web UI. For a BM25-only install without those downloads (~40 MB vs ~250 MB), see the [minimal install option](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/getting-started.md#option-a-from-pypi-recommended-for-most-users) in the Getting Started guide. > If `mm --version` shows an older version than the [latest release](https://github.com/memtomem/memtomem/releases) right after installing, `uv` is likely serving cached PyPI metadata โ€” re-run with `uv tool install 'memtomem[all]' --refresh`, or clear the cache first: `uv cache clean memtomem`. To upgrade an existing uv tool install, use `mm upgrade` rather than re-running `uv tool install`; see the [CLI reference](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/reference/data-config-cli.md#cli-reference) for what it preserves and stops. > **`mm: command not found`?** `uv tool install` drops the shim into `~/.local/bin`, which isn't on `$PATH` in fresh shells on macOS/Linux. Run `uv tool update-shell`, then open a new shell and re-run `mm --version`. ### 2. Setup > **After upgrading the Claude plugin:** re-check `/mcp` after reloading. > The plugin launches `memtomem[onnx]==0.6.5`. A manual registration whose launch > differs โ€” base-only `memtomem`, or the ONNX launch pinned to an earlier > release โ€” no longer matches for deduplication and may expose > duplicate tools. Confirm the manual entry's name and scope, then align its > launch command with the plugin or remove that redundant registration. ```bash mm init # preset picker, then memory_dir + MCP ``` The interactive picker starts with three presets โ€” **Minimal** (BM25, no downloads), **English (Recommended)** (ONNX `multilingual-e5-small` + English reranker + auto-discover providers), **Korean-optimized** (ONNX `multilingual-e5-small` + `kiwipiepy` tokenizer + multilingual reranker) โ€” plus an **Advanced** entry that opens the full 10-step wizard. Preset paths only ask about the memory directory and MCP registration; everything else is set from the preset. Choose **Minimal** for the fastest no-download first proof; rerun `mm init` later when you are ready to add semantic search. > **Indexing vs. discovery (Claude Code):** provider memory folders that setup auto-discovers (e.g. `~/.claude/projects/*/memory/`) are added to the search *index*. That is separate from the Web UI's opt-in Context Gateway scan of `~/.claude/projects/`, which discovers project *roots* for Skills, Custom Commands, and Subagents โ€” see [Configuration โ†’ Context Gateway](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/configuration.md#context-gateway) for the distinction and the lossy-slug caveats. For automation / CI: ```bash mm init --non-interactive # minimal preset, no prompts mm init --preset korean --non-interactive # Korean-optimized bundle, no prompts mm init --advanced # force the full 10-step wizard ``` See [Embeddings](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/embeddings.md) for the full model/provider matrix. ### 3. Verify a complete memory round trip The first success path does not require an existing notes directory or a connected editor: ```bash mm status mm add "Deployment checklist uses blue-green rollout" --tags ops mm search "blue-green" ``` `mm add` writes to your configured user memory directory and indexes the entry immediately. The final command should return the sentence you just added. Then verify the editor connection: ```text "Call the mem_status tool" ``` To bring existing notes into the same index, point `mm index` at a directory that already exists: ```bash mm index /path/to/your/notes ``` `mm status --json` (or `--format json`) provides the same status as machine-readable output for scripts and CI. ### 4. Open the Web UI (optional) ```bash mm web # polished dashboard on http://127.0.0.1:8080 mm web -b # run in the background; logs go to ~/.memtomem/logs/web.log mm web status # show pid/port/start time mm web stop # stop the tracked Web UI process mm web --dev # maintainer surface (adds opt-in pages) ``` `mm web` shows the polished page set by default. Pass `--dev` (or set `MEMTOMEM_WEB__MODE=dev` in your shell profile) to expose maintainer pages like Namespaces, Sessions, Working Memory, and Health Report.
Other install options **Minimal** (BM25-only, ~40 MB): ```bash uv tool install memtomem # no extras โ€” dense search, web UI, Korean tokenizer unavailable until you add them ``` Opt in later per-feature: `uv tool install --reinstall 'memtomem[onnx,web]'` (see the [extras table](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/getting-started.md#optional-extras)). **Project-scoped** (per-project isolation): ```bash uv add 'memtomem[all]' && uv run mm init # all commands need `uv run` prefix ``` **No install** (uvx on demand): ```bash claude mcp add memtomem -s user -- uvx --isolated --from "memtomem[all]==0.6.5" memtomem-server ``` See [MCP Client Setup](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/mcp-clients.md) for OpenCode / Codex / Cursor / Windsurf / Claude Desktop / Gemini CLI / Kimi Code.
--- ## Key Features - **Hybrid search** โ€” BM25 keyword + dense vector + RRF fusion in one query - **Semantic chunking** โ€” heading-aware Markdown, AST-based Python, tree-sitter JS/TS, structure-aware JSON/YAML/TOML - **Incremental indexing** โ€” chunk-level SHA-256 diff; only changed chunks get re-embedded - **Namespaces** โ€” organize memories into scoped groups with auto-derivation from folder names; review and label them (colour, description) from Settings โ†’ Namespaces in the Web UI - **Maintenance** โ€” near-duplicate detection, time-based decay, TTL expiration, auto-tagging - **Web UI** โ€” visual dashboard for search, sources, tags, timeline, dedup, and more (`mm web --dev` for the full maintainer surface) - **Context Gateway** โ€” keep canonical Skills, Commands, and Subagents in a project or user Store, optionally install reusable assets from a separate Wiki, then push them to supported AI runtimes. See [Context Gateway](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/context-gateway.md). - **MCP tools** โ€” `mem_do` meta-tool routes all non-core actions in `core` mode for minimal context usage - **Predictable core** โ€” memory operations run on explicit CLI/MCP calls (`mm add`, `mem_add`, `mem_index`, etc.). Optional client hooks are installed and removed separately rather than being a hidden runtime default. - **Scriptable CLI** โ€” `--json` output on `mm status` and write commands (`mm add` / `mm reset` / `mm purge`); `mm warmup` pre-loads local models so the first query skips the cold-start cost - **Scheduled jobs** โ€” `mm schedule add/list/run-now/delete` (or `mem_do(action="schedule_*")`) for cron-driven compaction, importance decay, dead-link cleanup, and dedup scans - **Pinned Context** โ€” keep small user/project/agent Markdown blocks ahead of retrieved results with `mm pinned compose` - **LangGraph Store** โ€” optional `MemtomemBaseStore` implements LangGraph's tuple-namespace long-term-memory contract - **[Hybrid LangGraph Store](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/langgraph-hybrid-store.md)** โ€” `MemtomemHybridStore` adds dedicated SQLite persistence, BM25/dense/RRF retrieval, TTL, and diagnostics --- ## Ecosystem | Package | Description | |---------|-------------| | [**memtomem**](https://pypi.org/project/memtomem/) | Core โ€” MCP server, CLI, Web UI, hybrid search, storage | | [**opencode-memtomem**](https://github.com/memtomem/memtomem/blob/HEAD/packages/opencode-memtomem/) | OpenCode โ€” exact-pinned MCP, commands, read skills, safe permissions | | [**memtomem-stm**](https://github.com/memtomem/memtomem-stm) | STM proxy โ€” proactive memory surfacing via tool interception | --- ## Documentation Hosted at **[memtomem.com](https://memtomem.com)** โ€” also available as Markdown in this repo. New to memtomem? The guides have a [suggested reading order](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/README.md). The table below follows it: | Guide | Description | |-------|-------------| | [Getting Started](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/getting-started.md) | Install, configure, save and find your first memory | | [ํ•œ๊ตญ์–ด ๋ฐ”์ด๋ธŒ์ฝ”๋”ฉ ๋น ๋ฅธ ์‹œ์ž‘](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/vibe-coding-getting-started-ko.md) | Claude CodeยทCodex CLI์—์„œ 10~15๋ถ„ ์•ˆ์— ๊ธฐ์–ต ์ €์žฅยท๊ฒ€์ƒ‰ | | [Example notebooks](https://github.com/memtomem/memtomem/blob/HEAD/examples/notebooks/) | Start with 00: recover decisions, code, and settings across 150 synthetic files without a model (Korean); 01โ€“04 teach APIs, 05โ€“06 teach LangGraph | | [Coding-agent sample](https://github.com/memtomem/memtomem/blob/HEAD/examples/onboarding/retry-policy/) | Recover a decision and its ADR source across sessions; isolated CLI proof and copyable prompts | | [ํ”„๋กœ์ ํŠธ ์—…๋ฌด๋ณ„ ์ฒดํ—˜](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/workflow-packages-ko.md) | ๊ฐœ๋ฐœ ์ž‘์—… ์ธ๊ณ„ยท์ œํ’ˆ ์˜์‚ฌ๊ฒฐ์ •ยท์˜จ๋ณด๋”ฉ: ๋ชจ๋ธ ์—†๋Š” ์ฒดํ—˜, ๊ธฐ๋ก ์–‘์‹, 2์ฃผ ํŒŒ์ผ๋Ÿฟ | | [MCP Client Setup](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/mcp-clients.md) | Editor-specific configuration | | [Cross-runtime handoff](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/integrations/cross-runtime-handoff.md) | Claude CodeยทCodex CLIยทKimi Code ์ˆœ์ฐจ ๊ณต๋™ ๊ฐœ๋ฐœ | | [Core memory tools](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/reference/core-memory-tools.md) | Index existing notes, search, and manage memories | | [Configuration](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/configuration.md) | Supported config files, precedence, and `MEMTOMEM_*` variables | | [Embeddings](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/embeddings.md) | ONNX, Ollama, and OpenAI embedding providers | | [LLM Providers](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/llm-providers.md) | Ollama, OpenAI, Anthropic, and compatible endpoints | | [Context Gateway](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/context-gateway.md) | Share Skills, Commands, and Subagents across your AI tools from one Store | | [Multi-device sync](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/multi-device-sync.md) | Sync markdown memories across personal devices via a private git repo | | [Operations & troubleshooting](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/reference/operations.md) | Web UI, privacy audits, diagnostics, and recovery | | [Reference](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/reference.md) | Complete tool and workflow reference | | [Uninstalling memtomem](https://github.com/memtomem/memtomem/blob/HEAD/docs/guides/uninstall.md) | Clean removal steps | --- ## Contributing See [CONTRIBUTING.md](https://github.com/memtomem/memtomem/blob/HEAD/CONTRIBUTING.md) for setup instructions and the contributor guide. ## License [Apache License 2.0](https://github.com/memtomem/memtomem/blob/HEAD/LICENSE). Contributions are accepted under the terms of the [Contributor License Agreement](https://github.com/memtomem/memtomem/blob/HEAD/CLA.md).