Persist and retrieve project context across Claude Code sessions by saving architectural decisions, bug fixes, and implementation details to Supermemory, then searching past memories or indexing your codebase for automatic context on session start.
Save important project knowledge to memory. Use when user wants to preserve architectural decisions, significant bug fixes, design patterns, or important implementation details for team reference.
Search your coding memory. Use when user asks about past work, previous sessions, how something was implemented, what they worked on before, or wants to recall information from earlier sessions.
✨ Requires Supermemory Pro or above - Unlock the state of the art memory for your Claude code.
A Claude Code plugin that gives your AI persistent memory across sessions using Supermemory. Your agent remembers what you worked on - across sessions, across projects.
/plugin marketplace add supermemoryai/claude-supermemory
/plugin install claude-supermemory
Set your API key (get one at app.supermemory.ai):
export SUPERMEMORY_CC_API_KEY="sm_..."
| Command | Description |
|---|---|
/claude-supermemory:index | Index codebase architecture and patterns |
/claude-supermemory:project-config | Configure project-level settings |
/claude-supermemory:logout | Clear saved credentials |
Environment
SUPERMEMORY_CC_API_KEY=sm_... # Required
SUPERMEMORY_DEBUG=true # Optional: enable debug logging
Global Settings — ~/.supermemory-claude/settings.json
{
"maxProfileItems": 5,
"signalExtraction": true,
"signalKeywords": ["remember", "architecture", "decision", "bug", "fix"],
"signalTurnsBefore": 3,
"includeTools": ["Edit", "Write"]
}
| Option | Description |
|---|---|
maxProfileItems | Max memories in context (default: 5) |
signalExtraction | Only capture important turns (default: false) |
signalKeywords | Keywords that trigger capture |
signalTurnsBefore | Context turns before signal (default: 3) |
includeTools | Tools to explicitly capture |
Project Config — .claude/.supermemory-claude/config.json
Per-repo overrides. Run /claude-supermemory:project-config or create manually:
{
"apiKey": "sm_...",
"repoContainerTag": "my-team-project",
"signalExtraction": true
}
| Option | Description |
|---|---|
apiKey | Project-specific API key |
personalContainerTag | Override personal container |
repoContainerTag | Override team container tag |
MIT
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
npx claudepluginhub supermemoryai/claude-supermemory --plugin supermemoryPersistent memory across Claude Code sessions using Cognis
Memory compression system for Claude Code - persist context across sessions
Persistent memory for Claude Code. Capture work across sessions and recall relevant context.
Long-term memory for Claude Code. Recalls architecture, conventions, and decisions across sessions, plus an episodic observation log of what happened — so Claude explains your codebase without file traversal, follows your patterns, learns from corrections, and never re-asks what it already learned.
Persistent memory system for Claude Code with SQLite, FTS5, and vector search
Persistent memory system for Claude Code with enforced context