Claude Engram

claude-engram

Status: I'm no longer working on claude-engram. Its last code change was July 17, 2026; since then only this README has changed. It was my first experiment in giving Claude a memory of its own, and my current work on that idea is Counterparts.

What carries over if you move:

- There's no importer; nothing moves by itself.
- ~/.claude-engram stays as it is. Counterparts keeps its memory in ~/.counterparts and refuses to put its store inside the old folder.
- The terminal setup leaves claude-engram's hooks alone, so both memories load at each session start, and claude-engram keeps making its calls on your API key, until you turn claude-engram off.
- To bring across what still holds, ask Claude in a session to read ~/.claude-engram/identity/core.md and the files in ~/.claude-engram/identity/people/, and remember what's still true in its own words. With the terminal install, counterparts note "Prefers short answers." --kind person adds one memory by hand. The plugin install has no counterparts command.
- Episodes stay where they are, as Markdown files in ~/.claude-engram/episodes/.

Install Counterparts. You already have bun from claude-engram (Counterparts needs 1.3 or newer; bun upgrade if yours is older), so in a terminal:

Then restart Claude Code. Or run /plugin marketplace add mlapeter/counterparts and then /plugin install counterparts@counterparts inside Claude Code. With Node 22.15 or newer, npm install -g counterparts@latest works too.

The full comparison, with the steps for bringing old notes across and turning claude-engram off: claude-engram vs Counterparts: stay or move?

Brain-inspired persistent memory for Claude Code. Memory *for* Claude, not notes *about* you: episodes Claude writes in its own voice, an identity it authors and maintains…