memU
Memory framework
First committed by evan-ak
Published in NevaMind-AI/memU. Publisher page
14,613 GitHub stars
What it is
Personal memory across agents
AutoGineer overview, from the brain’s own files
memU is an agent-driven memory system designed to provide persistent knowledge across different AI agents, sessions, and devices. It functions as a sidecar to desktop coding agents, automatically mining session logs to extract reusable skills and workflows. These skills are stored as Markdown files, which the agent can then retrieve and apply to future tasks. The system is designed to be storage-agnostic, supporting local SQLite databases for single-device use or Postgres for concurrent access, and it integrates with various coding agents through dedicated host adapters.
How it works
Memory model: LLM wiki
AutoGineer overview, from the brain’s own files
memU operates by installing a scheduled background task that monitors agent session logs. It slices these logs into jobs, which the agent then processes to create or update Markdown-based skill files. These skills are indexed and stored in a configured backend. When an agent performs a task, it uses a standing instruction to trigger a retrieval process, which fetches relevant skills from the memory store and injects them into the agent's context.
| Folder | Role | Files |
|---|---|---|
| .github | agent-config | 10 |
| assets | attachments | 24 |
| docs | docs | 25 |
| scripts | scripts | 1 |
| src | source-code | 190 |
| tests | tests | 69 |
| npm | folder | 3 |
The agent reads
- src/memu/database/postgres/migrations/ evidence: AGENTS.md
The agent writes
- src/memu/database/repositories/ evidence: AGENTS.md
- README.md evidence: AGENTS.md
- npm/README.md evidence: AGENTS.md
- docs/adr/ evidence: AGENTS.md
Requirements
Runtimes: Python >=3.11
Databases: PostgreSQL, SQLite
API keys (by name): MEMU_API_KEY, OPENAI_API_KEY
Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Google Antigravity, Kiro, OpenCode, Amp, Roo Code, Cline, JetBrains Junie, Devin (ex-Windsurf)
Set it up
This brain runs code automatically: 4 scripts. Review Makefile, src/memu/hosts/claude_code/install.py, src/memu/hosts/codex/install.py, src/memu/hosts/pi/install.py before opening the folder in Claude Code. No step below turns a hook on for you.
Makefile:echo "🚀 Creating virtual environment using uv"; uv sync; uv run pre-commit installsrc/memu/hosts/claude_code/install.py:python src/memu/hosts/claude_code/install.pysrc/memu/hosts/codex/install.py:python src/memu/hosts/codex/install.pysrc/memu/hosts/pi/install.py:python src/memu/hosts/pi/install.py
- Not scanned by AutoGineerIts dependencies are installed by pip or uv when you run it and were not scanned by AutoGineer (7 declared). https://pypi.org/project/memu-cli/
First committed by evan-ak. Published in NevaMind-AI/memU. Licence: Apache License 2.0.
Usage
AutoGineer overview, from the brain’s own files
- Install memU via the provided CLI or agent-specific instructions.
- Configure the memory backend using a local SQLite file or a Postgres DSN.
- Allow the background task to automatically distill agent history into Markdown skills.
- Use the agent's integrated retrieval mechanism to access relevant past skills during new tasks.
- Manage memory settings and storage via the memU CLI or environment variables.
- Use the doctor command to verify the configuration and retrieval path.
- “memu-codex retrieve "What should I remember about this project?"”
- The system returns relevant memory hits containing text, descriptions, and paths from previous sessions.
- “memu-agent detect”
- The system probes the machine to identify the agent and reports if memorization and retrieval are supported.
Documentation by evan-ak
<div align="center">
memU
Personal memory, stored as Wiki
Across Sessions. Across Agents. Across Devices.
Image: PyPI version Image: License: Apache 2.0 Image: Python 3.11+ Image: Discord Image: Twitter
<a href="https://trendshift.io/repositories/17374" target="_blank"><img src="https://trendshift.io/api/badge/repositories/17374" alt="NevaMind-AI%2FmemU | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
</div>
memU is a lightweight, agent-driven memory system that gives users a shared LLM wiki across sessions, agents, and devices. It automatically distills your own reusable skills from your agent history. Its core memory logic is only 500 lines — compact enough to inspect, understand, and adapt.
Quick start
memU works with Codex, Claude Code, Cursor, OpenClaw, Hermes, WorkBuddy, Cola, pi, and more. See Host adapters.
Cross-device · Free · Unlimited · View online
Get your API key from memu.so, then send this message to your agent:
Read https://memu.pro/SKILL.md, follow its instructions to install and configure memU, API Key is memu_•••••••••(get Api Key from memu.so).
Agent support
This matrix lists the currently tested memU integrations by operating system.
Memorize — capture useful session knowledge through a scheduled background task and turn it into reusable memory.
Retrieve — bring relevant memory into a future task.
⚠️ — supported with an important limitation; see the user note.
macOS
| Agent | Mode | Memorize | Retrieve | User note |
|---|---|---|---|---|
| ChatGPT | ChatGPT(Work mode), codex and VS Code extension | ✅ | ✅ | |
| ChatGPT | Chat | ❌ | ❌ | Chat mode is not currently supported. Please use Work mode. |
| Claude Code | Desktop and CLI | ✅ | ✅ | If the selected model declines the setup steps, retry with Opus or another model. Sonnet 5 can occasionally do this. |
| Claude | Chat and Cowork | ❌ | ❌ | |
| Cursor | — | ✅ | ✅ | |
| OpenClaw | — | ✅ | ✅ | Retrieve support has not yet been verified. |
| Hermes Agent | — | ✅ | ✅ | |
| WorkBuddy | — | ✅ | ✅ |
Windows
| Agent | Mode | Memorize | Retrieve | User note |
|---|---|---|---|---|
| ChatGPT | ChatGPT(Work mode), codex and VS Code extension | ✅ | ✅ | |
| ChatGPT | Chat | ❌ | ❌ | Chat mode is not currently supported. Please use Work mode. |
| Claude Code | Desktop and CLI | ✅ | ✅ | If the selected model declines the setup steps, retry with Opus or another model. Sonnet 5 can occasionally do this. |
| Claude | Chat and Cowork | ❌ | ❌ | |
| Cursor | — | ✅ | ✅ | |
| OpenClaw | — | ✅ | ✅ | |
| Hermes Agent | — | ✅ | ⚠️ | Use a memU version with Windows HERMES_HOME support; older versions may retrieve from the wrong files. |
| WorkBuddy | — | ✅ | ✅ | With Hy3, retrieval may fail. Retry with another model if this happens. |
Linux
| Agent | Mode | Memorize | Retrieve | User note |
|---|---|---|---|---|
| Codex | VS Code extension | ❌ | ✅ | |
| Claude Code | CLI | ✅ | ✅ | |
| OpenClaw | 4.23 / 7.1 | ✅ | ✅ |
Support status reflects the current release and may change as host integrations evolve.
How it works
Image: memU memory system architecture
Automatic skill extraction
Once the scheduled bridging task is installed, memU can turn useful agent history into reusable Markdown skills automatically.
Image: How memU turns agent history into reusable skills
Capture new sessions. The host adapter reads new session history, including messages and tool calls.
Prepare self-evolve jobs.
prepareslices each session into a self-contained job with the paths and context the agent needs.Let the agent decide. The agent reads related existing skills, then chooses to do nothing, patch an existing skill, or create a new one.
Write readable skill Markdown. Each skill has a name, description, and reusable workflow, including useful branches, edge cases, and pitfalls.
Commit and index.
commitsubmits changed skill files throughcommit_results; memU embeds the skill name and description and stores it under theskilltrack.Retrieve it later. On a similar future task, memU returns the relevant skill so any connected agent can use the learned workflow.
The judgment and synthesis stay inside the agent. MemoryService makes no LLM or chat calls; it stores, embeds, and retrieves the skill Markdown the agent prepared.
Self-hosted
Private · Single-device · Embedding key required
To run memU locally with your own storage and embedding provider, send this message to your agent:
Read https://raw.githubusercontent.com/NevaMind-AI/MemU/main/SKILL.md and follow it to install memU.
Uninstall
To uninstall memU, send this message to your agent:
Read https://memu.pro/SKILL.md and follow its instructions to uninstall memU.
By default, uninstalling removes the host integration and tooling while keeping your memory store and ~/.memu/config.env, so a later reinstall can resume where you left off. Memory is erased only when you explicitly ask for it.
Host adapters: memory for desktop coding agents
memU runs as a sidecar to a desktop agent, one binary per host. Each binds two seams:
record — a scheduled bridging task slices new session logs into self-contained job files; the agent itself distills them into memory/skill Markdown;
commitsubmits whatever the agent left on disk back throughcommit_results.inject — a standing instruction in the host's instruction file tells the agent to run
<binary> retrieve(→progressive_retrieve) before answering.
| Host | Binary | Session log it mines | Instruction file it patches |
|---|---|---|---|
| Codex | memu-codex | ~/.codex/sessions/**/*.jsonl | ~/.codex/AGENTS.md |
| Claude Code | memu-claude-code | ~/.claude/projects/<project>/<session>.jsonl | ~/.claude/CLAUDE.md |
| Cursor (Agent/CLI) | memu-cursor | ~/.cursor/projects/<project>/agent-transcripts/**.jsonl | ./AGENTS.md (per project) |
| OpenClaw | memu-openclaw | ~/.openclaw/agents/<agentId>/agent/openclaw-agent.sqlite (SQLite, read-only) + legacy <agentId>/sessions/*.jsonl | ~/.openclaw/workspace/AGENTS.md |
| Hermes Agent | memu-hermes | ~/.hermes/state.db (SQLite, read-only) | ~/.hermes/SOUL.md |
| WorkBuddy | memu-workbuddy | ~/.workbuddy/projects/<project>/<session>.jsonl | ~/.workbuddy/SOUL.md |
| Cola | memu-cola | ~/.cola/sessions/<scope>/<session>.jsonl | ~/.cola/memory-bank/MEMORY.md |
| pi | memu-pi | ~/.pi/agent/sessions/<encoded-cwd>/<session>.jsonl | ~/.pi/agent/AGENTS.md |
| any other agent | memu-agent | found by memu-agent detect (JSONL dialect sniffed) | found by detect (AGENTS.md / CLAUDE.md / SOUL.md / …) |
For agents without a dedicated binary, memu-agent detect probes the machine and reports per agent whether memorization works (a recognizable session log exists) and whether retrieval works (an instruction file exists to patch) — then the same verbs run against what it found.
All hosts share one configured memory backend via ~/.memu/config.env — local
or MemU Cloud. What one host's sessions taught memU, another host retrieves.
Installation is the one-message setup in Quick start or Self-hosted. SKILL.md is the routing skill it hands your agent: install the package, identify which host you are (falling back to memu-agent detect for anything without a dedicated adapter), print that host's packaged install guide (<binary> docs install), and follow it — configure the memory backend, register the scheduled bridging task, patch the instruction file, each step behind a verify gate — then report which seams (memorization / retrieval) are now active.
Afterwards <binary> doctor proves the whole loop resolves: config, selected
mode, and a live retrieval.
Adding another host means implementing one TranscriptSource (where its session logs live, how its records are shaped) plus a HostSpec-sized CLI — the pipeline, verbs, and instruction text are shared.
Developer integration
Use memu memorize to turn application-owned conversations into memory and skills.
CLI
With memU Cloud, sign in at memu.so to view your memory files. With a local installation, memory lives in the shared store configured by MEMU_DB in ~/.memu/config.env — typically ~/.memu/memu.sqlite3 for local SQLite, or a Postgres DSN.
Once installed, your agent retrieves relevant memory automatically before answering. To retrieve manually, run the adapter for your host:
memu-codex retrieve "What should I remember about this project?"
# or: memu-claude-code / memu-cursor / memu-openclaw / memu-hermes / memu-workbuddy / memu-cola / memu-pi / memu-agentFor pi, run memu-pi install to configure the memory backend and install the
extension, then run /reload or open a new session. Submitted prompts start
retrieval in the
background; results enter the model context and resume an idle agent. After the
user turn and pending retrieval settle, a background worker processes the saved
conversation into memory using the active session's model. Workers share a lock
and a 30-minute cooldown. Long prompts use an isolated, tool-free pi request to
extract a search query with the active provider/model; extraction has a 12-second
timeout and falls back to the original prefix. The installer registers and verifies
the extension. Run memu-pi uninstall and reload to remove it.
Host retrieval returns compact JSON with at most five self-contained hits plus independent resources. Each hit combines matched text with its source's description, track, and local mirror path (or inline content when no mirror is available). Its score describes the matched segment; created_at and updated_at describe the source file when available. Hits retain segment order, including excerpts whose source is missing; sources without matched excerpts remain source-only hits. Resources contain path, caption, and available scores/timestamps. Database IDs and scope metadata are omitted from the agent-facing output.
Install or invoke the CLI directly:
pip install memu-cli # library + memu + memu-codex CLIs
npx memu-cli --help # CLI via npm launcher (engine: PyPI package memu-cli)
uvx --from memu-cli memu # CLI via uv, no installConfiguration
Values resolve in order: process env → ~/.memu/config.env → default. memU
supports Local and Cloud memory backends, selected by MEMU_MEMORY_MODE; an
unset mode remains Local for backward compatibility.
For Local / self-hosted installations, every CLI flag has a matching variable:
| Setting | Env var | Default |
|---|---|---|
| Store | MEMU_DB | ./data/memu.sqlite3 (CLI); required for host adapters |
| Embedding provider | MEMU_EMBED_PROVIDER | openai (also: jina, voyage, doubao, openrouter); legacy MEMU_LLM_PROVIDER still read |
| API key | MEMU_API_KEY | the provider's env var, e.g. OPENAI_API_KEY |
| Embedding model | MEMU_EMBED_MODEL | the provider's default |
| Base URL | MEMU_BASE_URL | the provider's default |
Run <binary> doctor to display the resolved mode and verify the same retrieval
path the host uses.
Storage backends
| Provider | DSN | Vector search | Use for |
|---|---|---|---|
inmemory | — | brute-force cosine | tests, throwaway sessions |
sqlite | sqlite:///path.sqlite3 | brute-force cosine | local/default, single writer |
postgres | postgresql://... | pgvector | concurrent access, large stores (pip install "memu-cli[postgres]") |
service = MemoryService(
database_config={"metadata_store": {"provider": "postgres", "dsn": "postgresql://..."}},
embedding_profiles={"default": {"provider": "jina"}},
)Community contributions
Explore the community tasks (English / 简体中文) and claim a task in issue #790. Each task has a stable link, a difficulty rating, and acceptance criteria. See CONTRIBUTING.md for development and PR guidelines.
License
Apache-2.0
<sub>Partnership Community: <a href="https://linux.do">LINUX DO</a></sub>
LICENSE.txt
Shown as plain text.
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(which shall not include communication that is conspicuously
marked or otherwise designated in writing by the copyright owner
as "Not a Contribution").
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based upon (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and derivative works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control
systems, and issue tracking systems that are managed by, or on behalf
of, the Licensor for the purpose of discussing and improving the Work,
but excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution".
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to use, reproduce, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Work, and to
permit persons to whom the Work is furnished to do so, subject to
the following conditions:
The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Work.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, trademark, patent,
attribution and other notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright notice to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Support. You may choose to offer, and to
charge a fee for, warranty, support, indemnity or other liability
obligations and/or rights consistent with this License. However, in
accepting such obligations, You may act only on Your own behalf and
on Your sole responsibility, not on behalf of any other Contributor,
and only if You agree to indemnify, defend, and hold each Contributor
harmless for any liability incurred by, or claims asserted against,
such Contributor by reason of your accepting any such warranty or
support.
END OF TERMS AND CONDITIONS
Copyright 2024 MemU Team
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
339 files · 329 not served here
- .github/ISSUE_TEMPLATE/bug_report.yml (not served here)
- .github/ISSUE_TEMPLATE/config.yml (not served here)
- .github/ISSUE_TEMPLATE/feature_request.yml (not served here)
- .github/ISSUE_TEMPLATE/hackathon_task.yml (not served here)
- .github/ISSUE_TEMPLATE/improvement_suggestion.yml (not served here)
- .github/PULL_REQUEST_TEMPLATE.md (not served here)
- .github/workflows/build.yml (not served here)
- .github/workflows/pr-title.yml (not served here)
- .github/workflows/publish-memu-cli.yml (not served here)
- .github/workflows/release-please.yml (not served here)
- .gitignore (not served here)
- .pre-commit-config.yaml (not served here)
- .python-version (not served here)
- AGENTS.md
- ATTRIBUTION.md
- AUTOGINEER-RUNS.md
- CHANGELOG.md
- CONTRIBUTING.md
- INSTALL-LATEST.md
- LICENSE.txt
- MANIFEST.in (not served here)
- Makefile (not served here)
- README.md
- SKILL.md
- assets/banner.png (not served here)
- assets/benchmark.png (not served here)
- assets/memUbot.png (not served here)
- assets/memorize.png (not served here)
- assets/partners/Clawdchat.png (not served here)
- assets/partners/LazyLLM.png (not served here)
- assets/partners/buddie.png (not served here)
- assets/partners/bytebase.png (not served here)
- assets/partners/jazz.png (not served here)
- assets/partners/openagents.png (not served here)
- assets/partners/xroute.png (not served here)
- assets/qrcode.png (not served here)
- assets/retrieve.png (not served here)
- assets/skill-extraction.png (not served here)
- assets/star.gif (not served here)
- assets/structure-v2.png (not served here)
- assets/structure.png (not served here)
- assets/usecase/ai_companion-0000.jpg (not served here)
- assets/usecase/ai_creation-0000.jpg (not served here)
- assets/usecase/ai_edu-0000.jpg (not served here)
- assets/usecase/ai_ip-0000.png (not served here)
- assets/usecase/ai_robot-0000.jpg (not served here)
- assets/usecase/ai_role_play-0000.jpg (not served here)
- assets/usecase/ai_therapy-0000.jpg (not served here)
- docs/adr/0001-workflow-pipeline-architecture.md (not served here)
- docs/adr/0002-pluggable-storage-and-vector-strategy.md (not served here)
- docs/adr/0003-user-scope-in-data-model.md (not served here)
- docs/adr/0004-workspace-memorize-and-memory-file-system.md (not served here)
- docs/adr/0005-dedicated-embedding-package.md (not served here)
- docs/adr/0006-from-memory-item-category-to-tracked-workspace-memorization.md (not served here)
- docs/adr/0007-three-independent-memory-lines-wiki-graph.md (not served here)
- docs/adr/0008-two-integration-surfaces-hooks-and-api.md (not served here)
- docs/adr/0009-codex-packaging-cli-and-config.md (not served here)
- docs/adr/0010-multi-host-adapters.md (not served here)
- docs/adr/0011-generic-host-adapter.md (not served here)
- docs/adr/0012-cloud-backed-agentic-backend.md (not served here)
- docs/adr/0013-self-updating-instruction-templates.md (not served here)
- docs/adr/0014-paginated-list-all-recall-files.md (not served here)
- docs/adr/0015-bridging-must-not-mine-its-own-run.md (not served here)
- docs/adr/0016-client-event-reporting.md (not served here)
- docs/adr/0017-config-env-as-a-command.md (not served here)
- docs/adr/0018-cowork-through-claude-code-bridge.md (not served here)
- docs/adr/0019-developer-run-workspaces.md (not served here)
- docs/adr/0020-self-contained-host-retrieval-hits.md (not served here)
- docs/adr/0021-pi-extension-hooks.md (not served here)
- docs/adr/README.md (not served here)
- docs/community/tasks.en.md (not served here)
- docs/community/tasks.md (not served here)
- docs/sqlite.md
- npm/README.md (not served here)
- npm/bin/memu.js (not served here)
- npm/package.json (not served here)
- pyproject.toml (not served here)
- scripts/db.py (not served here)
- setup.cfg (not served here)
- src/memu/__init__.py (not served here)
- src/memu/__main__.py (not served here)
- src/memu/agentic_backend.py (not served here)
- src/memu/app/__init__.py (not served here)
- src/memu/app/agentic.py (not served here)
- src/memu/app/client_pool.py (not served here)
- src/memu/app/memorize/__init__.py (not served here)
- src/memu/app/memorize/input.py (not served here)
- src/memu/app/memorize/lifecycle.py (not served here)
- src/memu/app/memorize/materialize.py (not served here)
- src/memu/app/service.py (not served here)
- src/memu/app/settings.py (not served here)
- src/memu/cli.py (not served here)
- src/memu/cloud.py (not served here)
- src/memu/config_file.py (not served here)
- src/memu/database/__init__.py (not served here)
- src/memu/database/factory.py (not served here)
- src/memu/database/inmemory/__init__.py (not served here)
- src/memu/database/inmemory/models.py (not served here)
- src/memu/database/inmemory/repo.py (not served here)
- src/memu/database/inmemory/repositories/__init__.py (not served here)
- src/memu/database/inmemory/repositories/filter.py (not served here)
- src/memu/database/inmemory/repositories/recall_file_repo.py (not served here)
- src/memu/database/inmemory/repositories/recall_file_segment_repo.py (not served here)
- src/memu/database/inmemory/repositories/resource_repo.py (not served here)
- src/memu/database/inmemory/state.py (not served here)
- src/memu/database/inmemory/vector.py (not served here)
- src/memu/database/interfaces.py (not served here)
- src/memu/database/models.py (not served here)
- src/memu/database/postgres/__init__.py (not served here)
- src/memu/database/postgres/migration.py (not served here)
- src/memu/database/postgres/migrations/__init__.py (not served here)
- src/memu/database/postgres/migrations/env.py (not served here)
- src/memu/database/postgres/migrations/script.py.mako (not served here)
- src/memu/database/postgres/migrations/versions/20260703_0001_initial_schema.py (not served here)
- src/memu/database/postgres/models.py (not served here)
- src/memu/database/postgres/postgres.py (not served here)
- src/memu/database/postgres/repositories/__init__.py (not served here)
- src/memu/database/postgres/repositories/base.py (not served here)
- src/memu/database/postgres/repositories/recall_file_repo.py (not served here)
- src/memu/database/postgres/repositories/recall_file_segment_repo.py (not served here)
- src/memu/database/postgres/repositories/resource_repo.py (not served here)
- src/memu/database/postgres/schema.py (not served here)
- src/memu/database/postgres/session.py (not served here)
- src/memu/database/repositories/__init__.py (not served here)
- src/memu/database/repositories/recall_file.py (not served here)
- src/memu/database/repositories/recall_file_segment.py (not served here)
- src/memu/database/repositories/resource.py (not served here)
- src/memu/database/sqlite/__init__.py (not served here)
- src/memu/database/sqlite/models.py (not served here)
- src/memu/database/sqlite/repositories/__init__.py (not served here)
- src/memu/database/sqlite/repositories/base.py (not served here)
- src/memu/database/sqlite/repositories/recall_file_repo.py (not served here)
- src/memu/database/sqlite/repositories/recall_file_segment_repo.py (not served here)
- src/memu/database/sqlite/repositories/resource_repo.py (not served here)
- src/memu/database/sqlite/schema.py (not served here)
- src/memu/database/sqlite/session.py (not served here)
- src/memu/database/sqlite/sqlite.py (not served here)
- src/memu/database/state.py (not served here)
- src/memu/embedding/__init__.py (not served here)
- src/memu/embedding/backends/__init__.py (not served here)
- src/memu/embedding/backends/base.py (not served here)
- src/memu/embedding/backends/doubao.py (not served here)
- src/memu/embedding/backends/jina.py (not served here)
- src/memu/embedding/backends/openai.py (not served here)
- src/memu/embedding/backends/openrouter.py (not served here)
- src/memu/embedding/backends/voyage.py (not served here)
- src/memu/embedding/base.py (not served here)
- src/memu/embedding/defaults.py (not served here)
- src/memu/embedding/gateway.py (not served here)
- src/memu/embedding/http_client.py (not served here)
- src/memu/embedding/openai_sdk.py (not served here)
- src/memu/env.py (not served here)
- src/memu/events.py (not served here)
- src/memu/hosts/__init__.py (not served here)
- src/memu/hosts/base.py (not served here)
- src/memu/hosts/bridging/__init__.py (not served here)
- src/memu/hosts/bridging/instructions.py (not served here)
- src/memu/hosts/bridging/layout.py (not served here)
- src/memu/hosts/bridging/manifest.py (not served here)
- src/memu/hosts/bridging/pipeline.py (not served here)
- src/memu/hosts/bridging/recall_files.py (not served here)
- src/memu/hosts/bridging/resources.py (not served here)
- src/memu/hosts/bridging/self_sessions.py (not served here)
- src/memu/hosts/bridging/transcripts.py (not served here)
- src/memu/hosts/claude_code/BRIDGING_TASK.md (not served here)
- src/memu/hosts/claude_code/INSTALL.md (not served here)
- src/memu/hosts/claude_code/UNINSTALL.md (not served here)
- src/memu/hosts/claude_code/__init__.py (not served here)
- src/memu/hosts/claude_code/auth.py (not served here)
- src/memu/hosts/claude_code/cli.py (not served here)
- src/memu/hosts/claude_code/cli_prepare.py (not served here)
- src/memu/hosts/claude_code/cowork_cmd.py (not served here)
- src/memu/hosts/claude_code/desktop_sessions.py (not served here)
- src/memu/hosts/claude_code/doctor.py (not served here)
- src/memu/hosts/claude_code/hook_install.py (not served here)
- src/memu/hosts/claude_code/install.py (not served here)
- src/memu/hosts/claude_code/memorize_hook.py (not served here)
- src/memu/hosts/claude_code/prompt_hook.py (not served here)
- src/memu/hosts/claude_code/query_extraction.py (not served here)
- src/memu/hosts/claude_code/sessions.py (not served here)
- src/memu/hosts/claude_code/submit.py (not served here)
- src/memu/hosts/claude_code/uninstall.py (not served here)
- src/memu/hosts/claude_records.py (not served here)
- src/memu/hosts/cli_install.py (not served here)
- src/memu/hosts/codex/BRIDGING_TASK.md (not served here)
- src/memu/hosts/codex/INSTALL.md (not served here)
- src/memu/hosts/codex/UNINSTALL.md (not served here)
- src/memu/hosts/codex/__init__.py (not served here)
- src/memu/hosts/codex/cli.py (not served here)
- src/memu/hosts/codex/cli_prepare.py (not served here)
- src/memu/hosts/codex/doctor.py (not served here)
- src/memu/hosts/codex/hook_status.py (not served here)
- src/memu/hosts/codex/install.py (not served here)
- src/memu/hosts/codex/memorize_hook.py (not served here)
- src/memu/hosts/codex/notify_console.py (not served here)
- src/memu/hosts/codex/prompt_hook.py (not served here)
- src/memu/hosts/codex/prompt_hook_install.py (not served here)
- src/memu/hosts/codex/query_extraction.py (not served here)
- src/memu/hosts/codex/sessions.py (not served here)
- src/memu/hosts/codex/uninstall.py (not served here)
- src/memu/hosts/cola/BRIDGING_TASK.md (not served here)
- src/memu/hosts/cola/INSTALL.md (not served here)
- src/memu/hosts/cola/UNINSTALL.md (not served here)
- src/memu/hosts/cola/__init__.py (not served here)
- src/memu/hosts/cola/cli.py (not served here)
- src/memu/hosts/cola/sessions.py (not served here)
- src/memu/hosts/config_cmd.py (not served here)
- src/memu/hosts/cowork/__init__.py (not served here)
- src/memu/hosts/cowork/sessions.py (not served here)
- src/memu/hosts/cursor/BRIDGING_TASK.md (not served here)
- src/memu/hosts/cursor/INSTALL.md (not served here)
- src/memu/hosts/cursor/UNINSTALL.md (not served here)
- src/memu/hosts/cursor/__init__.py (not served here)
- src/memu/hosts/cursor/cli.py (not served here)
- src/memu/hosts/cursor/sessions.py (not served here)
- src/memu/hosts/generic/BRIDGING_TASK.md (not served here)
- src/memu/hosts/generic/INSTALL.md (not served here)
- src/memu/hosts/generic/UNINSTALL.md (not served here)
- src/memu/hosts/generic/__init__.py (not served here)
- src/memu/hosts/generic/cli.py (not served here)
- src/memu/hosts/generic/detect.py (not served here)
- src/memu/hosts/generic/sessions.py (not served here)
- src/memu/hosts/hermes/BRIDGING_TASK.md (not served here)
- src/memu/hosts/hermes/INSTALL.md (not served here)
- src/memu/hosts/hermes/UNINSTALL.md (not served here)
- src/memu/hosts/hermes/__init__.py (not served here)
- src/memu/hosts/hermes/cli.py (not served here)
- src/memu/hosts/hermes/sessions.py (not served here)
- src/memu/hosts/hooks/__init__.py (not served here)
- src/memu/hosts/hooks/admission.py (not served here)
- src/memu/hosts/hooks/worker.py (not served here)
- src/memu/hosts/host_cli.py (not served here)
- src/memu/hosts/install_language.py (not served here)
- src/memu/hosts/installation.py (not served here)
- src/memu/hosts/instruction.py (not served here)
- src/memu/hosts/openclaw/BRIDGING_TASK.md (not served here)
- src/memu/hosts/openclaw/INSTALL.md (not served here)
- src/memu/hosts/openclaw/UNINSTALL.md (not served here)
- src/memu/hosts/openclaw/__init__.py (not served here)
- src/memu/hosts/openclaw/cli.py (not served here)
- src/memu/hosts/openclaw/cron_identity.py (not served here)
- src/memu/hosts/openclaw/sessions.py (not served here)
- src/memu/hosts/pi/BRIDGING_TASK.md (not served here)
- src/memu/hosts/pi/INSTALL.md (not served here)
- src/memu/hosts/pi/UNINSTALL.md (not served here)
- src/memu/hosts/pi/__init__.py (not served here)
- src/memu/hosts/pi/cli.py (not served here)
- src/memu/hosts/pi/hook_install.py (not served here)
- src/memu/hosts/pi/install.py (not served here)
- src/memu/hosts/pi/memorize_hook.py (not served here)
- src/memu/hosts/pi/prompt_hook.py (not served here)
- src/memu/hosts/pi/query_extraction.py (not served here)
- src/memu/hosts/pi/retrieval-extension.ts (not served here)
- src/memu/hosts/pi/sessions.py (not served here)
- src/memu/hosts/query_extraction.py (not served here)
- src/memu/hosts/retrieval.py (not served here)
- src/memu/hosts/scheduling/__init__.py (not served here)
- src/memu/hosts/scheduling/prompt.py (not served here)
- src/memu/hosts/scheduling/windows.py (not served here)
- src/memu/hosts/templates.py (not served here)
- src/memu/hosts/workbuddy/BRIDGING_TASK.md (not served here)
- src/memu/hosts/workbuddy/INSTALL.md (not served here)
- src/memu/hosts/workbuddy/UNINSTALL.md (not served here)
- src/memu/hosts/workbuddy/__init__.py (not served here)
- src/memu/hosts/workbuddy/cli.py (not served here)
- src/memu/hosts/workbuddy/sessions.py (not served here)
- src/memu/retry.py (not served here)
- src/memu/trust.py (not served here)
- src/memu/vector.py (not served here)
- tests/__init__.py (not served here)
- tests/conftest.py (not served here)
- tests/fixtures/cowork/audit.jsonl (not served here)
- tests/test_agentic.py (not served here)
- tests/test_bridging_promotion.py (not served here)
- tests/test_bridging_resources.py (not served here)
- tests/test_bridging_self_sessions.py (not served here)
- tests/test_cache_segment_duplicates.py (not served here)
- tests/test_claude_auth.py (not served here)
- tests/test_claude_cli_request.py (not served here)
- tests/test_claude_hook_encoding.py (not served here)
- tests/test_claude_install.py (not served here)
- tests/test_claude_memorize_hook.py (not served here)
- tests/test_claude_prompt_hook.py (not served here)
- tests/test_claude_query_extraction.py (not served here)
- tests/test_claude_submit.py (not served here)
- tests/test_cli.py (not served here)
- tests/test_cli_install_path.py (not served here)
- tests/test_cli_stdio.py (not served here)
- tests/test_cloud.py (not served here)
- tests/test_codex_cli_prepare.py (not served here)
- tests/test_codex_doctor.py (not served here)
- tests/test_codex_hook_status.py (not served here)
- tests/test_codex_install.py (not served here)
- tests/test_codex_memorize_context.py (not served here)
- tests/test_codex_memorize_cooldown.py (not served here)
- tests/test_codex_memorize_hook.py (not served here)
- tests/test_codex_prompt_hook.py (not served here)
- tests/test_codex_prompt_hook_install.py (not served here)
- tests/test_codex_query_extraction.py (not served here)
- tests/test_codex_query_limit.py (not served here)
- tests/test_codex_uninstall.py (not served here)
- tests/test_config_cmd.py (not served here)
- tests/test_cowork_sessions.py (not served here)
- tests/test_cowork_verify.py (not served here)
- tests/test_cursor_self_sessions.py (not served here)
- tests/test_doctor_proxy_hint.py (not served here)
- tests/test_embedding.py (not served here)
- tests/test_embedding_openrouter.py (not served here)
- tests/test_embedding_proxy.py (not served here)
- tests/test_env_passthrough.py (not served here)
- tests/test_events.py (not served here)
- tests/test_host_generic.py (not served here)
- tests/test_host_hook_admission.py (not served here)
- tests/test_host_hooks.py (not served here)
- tests/test_host_instruction.py (not served here)
- tests/test_host_retrieval.py (not served here)
- tests/test_host_sessions.py (not served here)
- tests/test_host_templates.py (not served here)
- tests/test_memorize_cli.py (not served here)
- tests/test_memorize_input.py (not served here)
- tests/test_memorize_lifecycle.py (not served here)
- tests/test_memorize_materialization.py (not served here)
- tests/test_memorize_runs.py (not served here)
- tests/test_openclaw_self_sessions.py (not served here)
- tests/test_pi_install.py (not served here)
- tests/test_pi_memorize_hook.py (not served here)
- tests/test_pi_memorize_live.py (not served here)
- tests/test_pi_prompt_hook.py (not served here)
- tests/test_pi_query_extraction.py (not served here)
- tests/test_postgres_migration_config.py (not served here)
- tests/test_recall_file_backfill.py (not served here)
- tests/test_scheduling_windows.py (not served here)
- tests/test_segment_vector_search.py (not served here)
- tests/test_sqlite_scope_roundtrip.py (not served here)
- tests/test_sqlite_segment_cache.py (not served here)
- tests/test_task_naming.py (not served here)
- tests/test_trust.py (not served here)
- tests/test_vector.py (not served here)
- uv.lock (not served here)
Advantages
- Automatically distills reusable skills from agent history without manual intervention. evidence: README.md
- Supports multiple storage backends including SQLite and Postgres for different deployment needs. evidence: README.md
Limitations
- Some agents require specific modes (e.g., Work mode) and do not support memory features in standard chat modes. evidence: README.md
- Certain models may decline setup steps, requiring a retry with a different model like Opus. evidence: README.md
Security
Risk level: Medium risk
This brain runs
Git hooks (2)
.pre-commit-config.yaml:pre-commit hooks from https://github.com/pre-commit/pre-commit-hooks at v6.0.0 (contributor tooling: runs only after pre-commit install)· uses the network.pre-commit-config.yaml:pre-commit hooks from https://github.com/astral-sh/ruff-pre-commit at v0.14.3 (contributor tooling: runs only after pre-commit install)· uses the network
Agent instructions that run or fetch something (14)
AGENTS.md:Setup: `make install`AGENTS.md:Run all tests: `make test`AGENTS.md:Run focused tests: `uv run python -m pytest tests/<target_test>.py`AGENTS.md:Full quality checks: `make check`SKILL.md:Each supported host has its own adapter binary carrying its own install guide.SKILL.md:Your job here is three steps: install the package, pick your binary, print and follow its guide.SKILL.md:it installs helper interfaces only and is harmless to run on a personal machine.SKILL.md:If you meet that error at any point, you are on a stale build: upgrade, then re-run the command that failed.SKILL.md:With uv this means `uv tool install --upgrade memu-cli`, **not** `uv pip install`: however it is installed, `memu-cli` is a cross-session bridging tool and must be callable everywhere, not scoped to one project venv.SKILL.md:Run:SKILL.md:If the user does not mention an API key, or would rather keep memory on this device, run bare `<your-binary> init` and Step 3's guide will set up local memory.SKILL.md:<your-binary> docs installSKILL.md:**Install in one pass;SKILL.md:Otherwise, after installation, run:
Install scripts (4)
Makefile(make install):echo "🚀 Creating virtual environment using uv"; uv sync; uv run pre-commit installsrc/memu/hosts/claude_code/install.py:python src/memu/hosts/claude_code/install.pysrc/memu/hosts/codex/install.py:python src/memu/hosts/codex/install.pysrc/memu/hosts/pi/install.py:python src/memu/hosts/pi/install.py
- Medium risk: runs-git-hook-remote-exec (.pre-commit-config.yaml:2)
- Medium risk: runs-git-hook-remote-exec (.pre-commit-config.yaml:15)
- Low risk: network-instructions (SKILL.md:33)
- Low risk: scripts-present (src/memu/hosts/claude_code/install.py)
- Low risk: scripts-present (src/memu/hosts/codex/install.py)
- Low risk: scripts-present (src/memu/hosts/pi/install.py)
Attribution and licence
- First committed by
evan-ak
- Declared authors
- MemU Team (declared in pyproject.toml)
- Publisher
- NevaMind AI (Community)
- Source
- NevaMind-AI/memU · commit fd86e38
- Licence
- Apache License 2.0 (files served here)
- ATTRIBUTION.md (written by AutoGineer)
- Synced
- Contributors
- sairin1202, xnne-bot, evan-ak, nevamind-agent, wutongyuonce
AutoGineer is not affiliated with or endorsed by evan-ak or NevaMind AI.
Install from source
329 of its files are not served here, so there is no ZIP. NevaMind-AI/memU at fd86e38