aimem

Memory,
made canonical.

One markdown source. Every AI tool reads from here. Edit once, the per-tool adapters keep the rest in sync — no more N copies that drift.

Open source Used in production MCP-ready
View on GitHub ↗ Install Why aimem
aimem ~/ai-memory docs/ config/ notes/ logs/ history/ data/ build-system + compact filter Claude Gemini Cursor Windsurf Cline Codex + more canonical source build step per-tool adapters
The problem

Every AI tool ships its own memory format.

CLAUDE.md, GEMINI.md, .aider.conf.yml, .cursorrules, AGENTS.md… seven files, all your context.

Maintaining N copies of "who I am, how I work, what we decided" across every assistant is a daily tax. They drift. They disagree. They're impossible to keep current. aimem fixes this by inverting the relationship: there is one canonical store, and the tools read derivative views of it.

Capabilities

Six things aimem does well.

Plain markdown at the bottom. Research-grounded structure on top. A build step in between that handles every tool's quirks.

01
Canonical markdown

Edit one file under docs/, config/, notes/… Everything else stays in sync because everything is generated.

02
Per-tool adapters

One build script emits AGENTS.md, CLAUDE.md, GEMINI.md, Aider config — exactly what each tool reads.

03
Structured taxonomy

Six unified memory kinds — documentation, semantic rules, workflows, event logs, reflections, references.

04
MCP-native

Runtime briefing, search, log-turn, write-proposal via Model Context Protocol. Live memory, not just static files.

05
42% token reduction

Compact-mode adapters strip Why and How rationale at build. Sources stay verbose for humans, adapters stay terse for context windows.

06
Open source, MIT

Hand-curated, single-author, public so others can fork. Used in production by Lx8 Labs across every project.

Backed by research

Built on peer-reviewed memory architectures.

aimem isn't an opinion. It's a working implementation of seven papers, in markdown.

CoALA · 2023 MemGPT · 2023 A-MEM · 2025 MEMP · 2025 MemoryBank · 2024 Mem0 · 2024 TiMem · 2026 Generative Agents · 2023
Install

Three commands, in under a minute.

Clone, build, symlink. From there: edit any markdown file and the tool-specific adapters regenerate.

# Clone the repo
git clone [email protected]:LeKCei/ai-memory.git ~/ai-memory
cd ~/ai-memory

# Generate adapters once and setup
make setup

# Daily workflow — edit anything under docs/, config/, notes/, etc.
make sync  # build, lint, commit (auto-message), push
Open on GitHub ↗ Why memory matters