agent-memory
One memory for Claude Code and Codex.
What your agents learn, kept as plain Markdown in a git repository you own.
Why agent-memory
- Tell one agent, both remember. A preference you give Codex is there the next time Claude Code starts, and the other way round, on every machine that pulls.
- The right memories in each session. Everything global, plus what was learned in this folder or repository, and nothing from your other projects.
- Memory in git. One Markdown file per memory in a git repository you own, with where it came from recorded by the hooks. Every change is a commit you can review or revert; add a private remote to sync machines, or keep it all on one. Here is an example.
- Nothing to run. Two hooks and git. No service, no account; search by meaning runs on your CPU.
- A page to keep it tidy.
mem uisearches by words and by meaning, edits with undo, and shows what changed week by week.
Quick start
See it first, with nothing installed:
uvx --from "agent-memory-git[ui]" mem ui --demo
Then set it up (Python 3.11+, git and uv):
uv tool install "agent-memory-git[ui]"
mem init ~/repos/agent-memory-data # your data repository
mem install --dry-run # every change, as a diff
mem install
Codex asks you to trust new hooks once: open /hooks in Codex and enable the three agent-memory
hooks. The docs cover importing existing
memories, every file mem install changes, upgrading and uninstalling.
How it works
At session start a hook gives the agent an index of the memories that apply where it runs. The agent saves what is worth keeping as Markdown files, following PROTOCOL.md, and at the end of each turn a hook records where each came from, commits and pushes. The docs explain the file format, where memories load, the commands and the configuration.
Contributing
uv sync --all-extras && uv run pytest
The mem ui page is plain HTML, CSS and JavaScript with no build step, and
uv run scripts/site.py serve runs the website and its live demo locally. More in the
docs.
License
1 maintainer
Metadata
1 maintainer
Release files for agent-memory-git 0.1.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| agent_memory_git-0.1.7.tar.gz | 97.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| agent_memory_git-0.1.7-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 219.9 kB
Release files / agent_memory_git-0.1.7.tar.gz
| Download URL | agent_memory_git-0.1.7.tar.gz |
|---|---|
| Size | 97.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a09e319192ed37ac7518a39f36b67a4fbd0cd62e13a1664972809f47018bd155
|
|
BLAKE2b-256 checksum How to use checksums |
53fbdb3abc3c300c851296af4ce2c31d81b4b047bab67893e3685e0ca54407c4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / agent_memory_git-0.1.7-py3-none-any.whl
| Download URL | agent_memory_git-0.1.7-py3-none-any.whl |
|---|---|
| Size | 122.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fc0b02353b91471f81829812d11e84c8786a7ba5b9628488296e2eaa77fb9fc1
|
|
BLAKE2b-256 checksum How to use checksums |
62ebac03dec518dca185b6987eed6ea7b6c641a2c9915ebac19272a5fe351002
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.13 {"installer":{"name":"uv","version":"0.12.13","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
