Claude Supermemory

claude-supermemory

Persistent memory for Claude Code, powered by Supermemory

Conceptual overview. Some command names in the image predate the current plugin; see Commands for what's available now.

A Claude Code plugin that gives your agent persistent memory across sessions using
Supermemory. Your agent remembers what you worked on, across
sessions and across projects.

Install · Features · How it works · Shared containers · Configuration · Commands · Privacy

Installation
Requires Node.js 18+ on your PATH. The memory hooks run as Node scripts.

Set your API key (get one at console.supermemory.ai),
or just start a session and let browser login handle it:

Migrating from the old claude-supermemory plugin

That plugin was renamed to supermemory, so it won't update in place. Migrate with:

Then, only if you still have the old plugin installed, remove it:

Features

- Recall strip — On Claude Code 2.1.287+ in the terminal, press the changing memory headline above the prompt to browse the full returned facts one at a time

On Claude Code 2.1.250, local marketplace install/update and the SessionStart and UserPromptSubmit command hooks were verified, but claude plugin validate rejects the recall mod's classic.SessionStart event. The strip is not available on that version; other older versions and install sources have not been verified.

How it works

Claude Code supports hooks and MCP servers. supermemory registers four hooks, in lifecycle order:

SessionStart → UserPromptSubmit → PreToolUse → Stop

By default, recall is performed by the hook itself, not delegated to the model. It searches
substantive prompts when authenticated, without waiting for Claude to choose a tool call.
Setting recallDirective switches to advisory mode: the hook stops searching and instead
tells…