What it does
AI agents usually forget everything when a session ends. agent-memory saves what they learn as plain Markdown files (simple text files) in one folder on your computer. Claude Code, Codex CLI, Muse Code and other tools that can run commands can all share that same folder.
When an agent needs to remember something, the tool searches the files locally and returns a ranked list of matching files. The agent then opens only as much of each file as it needs. New memories are written automatically at the end of conversations, and a separate 'sleep-time' pass tidies and combines memories later. Deletions only happen after you confirm them.
The search index is just a shortcut that can be deleted and rebuilt without losing anything, because the text files are the real record. Its makers say no API key is needed, because it borrows reasoning from the agent tool you already use.
Who it's for
People who use command-line AI coding agents like Claude Code or Codex and want them to remember past work between sessions.
Can I use it without coding?
Developers only. Installing requires Python, the uv tool and terminal commands, and there is no ready-made app yet. New to this? Start here.
Can I run it?
- Cost
- FreeNothing to pay or sign up for.
- Computer
- An ordinary computer is fine
- Privacy
- Runs on your own device: your data stays with you
- API key
- Not needed
Try it
- Install Python 3.12 or newer and the uv tool, then download the project's code.
- Set up the memory store with the project's init command.
- Connect it to your agent (Claude Code, Codex or Muse Code) with the setup command and check it reports ready.
Using Claude Code, Cursor or another AI coding assistant? Paste the prompt and it will walk you through the setup.New to this?
Before you install
- Only download from the official GitHub page. Copies with similar names exist for many popular projects.
- Plain-AyI is an independent guide and doesn't host or review the software it lists. Please check each project's official page before installing.
- License (MIT): Very permissive: free to use, change and share, including for business.
- More on staying safe