Switch AI agents without losing your place
ai-memory captures session context from Claude, Codex, and others into a git-backed markdown wiki so you can quit one agent and resume in another without starting from scratch.

What it does ai-memory is a Rust service that sits between you and your AI coding agents. It hooks into the lifecycle of Claude Code, OpenAI Codex, Cursor, and a dozen other clients, automatically logging every prompt, tool call, and decision to a plain-markdown wiki backed by git. When a session ends, it compiles the noise into coherent narrative pages; when a new agent starts in the same project, it prepends a “where you left off” handoff so you don’t re-explain the architecture or repeat failed approaches.
The interesting bit
Instead of a vector database or manual note-taking, the wiki is just markdown files in a git repository—grep-able, sync-able with rsync, and browsable in Obsidian or its built-in /web UI. The cross-agent handoff is the real trick: the project explicitly treats Claude, Codex, Grok, and others as interchangeable workers on the same shared memory, even when they refuse to read each other’s stdout. Grok and Zero currently need an explicit MCP call to accept handoffs, since they ignore SessionStart injection.
Key highlights
- Supports Claude Code, Codex, Cursor, Devin, Gemini CLI, OpenCode, and others via MCP configs and lifecycle hooks
- Stores memory as plain markdown in git—no vector DB, no
write_noteceremony - Per-project isolation with UUID-based paths; global scope for durable personal rules that follow you across projects
- Optional LLM-powered consolidation and auto-improvement scheduler that proposes wiki edits from finished sessions
- Built-in web UI with FTS5 search; runs locally or on a shared homelab/server with bearer-token auth
Caveats
- Claude Desktop and VS Code Copilot only get MCP access, not lifecycle hooks, so they can’t auto-capture or auto-inject handoffs
- Grok and Zero capture events but ignore
SessionStartstdout, forcing handoff recovery through an explicit MCP call - Native Windows support is experimental; WSL2 is the recommended path there
Verdict Worth a look if you routinely switch between Claude Code and Codex mid-project, or if you want a grep-able, git-versioned audit trail of why your agent made specific decisions. Skip it if you only ever use a single agent in short bursts and don’t mind repeating yourself.
Frequently asked
- What is akitaonrails/ai-memory?
- ai-memory captures session context from Claude, Codex, and others into a git-backed markdown wiki so you can quit one agent and resume in another without starting from scratch.
- Is ai-memory open source?
- Yes — akitaonrails/ai-memory is open source, released under the MIT license.
- What language is ai-memory written in?
- akitaonrails/ai-memory is primarily written in Rust.
- How popular is ai-memory?
- akitaonrails/ai-memory has 1k stars on GitHub.
- Where can I find ai-memory?
- akitaonrails/ai-memory is on GitHub at https://github.com/akitaonrails/ai-memory.