ai-memory

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="docs/logo-dark.png">
    <img alt="ai-memory" src="docs/logo-light.png" width="480">
  </picture>
</p>

> Long-term memory for AI coding agents. Quit Claude Code mid-task,
> start OpenAI Codex in the same directory, continue without
> re-explaining the architecture, the failed approaches, or the open
> questions.

**Website: [aimemory.sh](https://aimemory.sh)**

[![Website](https://img.shields.io/badge/website-aimemory.sh-blue)](https://aimemory.sh)
[![Release](https://img.shields.io/github/v/release/akitaonrails/ai-memory)](https://github.com/akitaonrails/ai-memory/releases/latest)
[![Rust](https://img.shields.io/badge/rust-1.95+-blue)](rust-toolchain.toml)
[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)

## Why ai-memory

Your coding agent probably has a memory feature already. Claude Code takes its
own notes, Cursor remembers some things, and every platform is adding more. They
all have the same limits: the notes live on one machine, belong to one agent,
and drop out of view when you switch tools or hand the work to a teammate.

ai-memory removes those limits.

- **It follows you across agents.** More than twenty harnesses (Claude Code,
  Codex, Cursor, Gemini CLI, OpenCode, Grok, Devin, Kimi, Kiro, and others)
  feed one shared memory. Quit Claude Code mid-task, open Codex in the same
  directory, and the next agent picks up a handoff that says where you left
  off, what failed, and what is still open. Handoffs are a typed protocol:
  each one has an owner and is claimed exactly once.

- **It can carry the session, not just a summary.** Start agents with
  `ai-memory run`: quit Claude Code, run `ai-memory run codex`, and Codex gets
  the shared workstream plus a private, temporary local projection of Claude's
  visible native history for exact details the bounded startup packet omitted.
  The remote server receives only the harness and session identity, never the
  local transcript path or body. Direct harness launches behave exactly as
  before.

- **It follows you across projects.** A small profile of how you usually
  work (your package manager, test layout, architecture habits) reaches
  every new repository at session start, so you stop re-explaining yourself.
  It sits below each repository's rules file as a default. It is on by
  default for a single user, and on a shared server it is opt-in and private
  per person. See [`docs/cross-project-profile.md`](docs/cross-project-profile.md).

- **It follows you across machines.** Memory lives in a server you run, on
  the same laptop, a homelab box, or anywhere else, so the project you left
  on the desktop is the project you resume on the laptop, with the same
  knowledge and the same open questions.

- **It works for a team.** Point everyone at one server, and what one
  person's sessions learn, everyone's agents can retrieve. Knowledge is
  shared per project; personal handoffs sta