← All projects
AI memory

agent-memory

Gives AI agents a lasting memory stored as plain text files you can read, search and keep.

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

  1. Install Python 3.12 or newer and the uv tool, then download the project's code.
  2. Set up the memory store with the project's init command.
  3. 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