claude-supermemory
NewPersistent memory across Claude Code sessions using Supermemory
Overview
<img width="4000" height="2130" alt="image (6)" src="https://github.com/user-attachments/assets/07e63ac4-b67d-457b-9029-1dc5d860e920" />
✨ Requires [Supermemory Pro or above](https://app.supermemory.ai/?view=integrations) - 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.
Features
- •Team Memory — Project knowledge shared across your team, separate from personal memories
- •Auto Capture — Conversations saved when session ends
- •Project Config — Per-repo settings, API keys, and container tags
Installation
/plugin marketplace add supermemoryai/claude-supermemory
/plugin install claude-supermemorySet your API key (get one at app.supermemory.ai):
export SUPERMEMORY_CC_API_KEY="sm_..."How It Works
- •supermemory-search — Ask about past work or previous sessions, Claude searches your memories
- •supermemory-save — Ask to save something important, Claude saves it for the team
Commands
| Command | Description |
|---|---|
/claude-supermemory:index | Index codebase architecture and patterns |
/claude-supermemory:project-config | Configure project-level settings |
/claude-supermemory:logout | Clear saved credentials |
/claude-supermemory:session | Show clickable URL for the current session document in Supermemory |
/claude-supermemory:status | Show authentication status |
Configuration
Environment
SUPERMEMORY_CC_API_KEY=sm_... # Required
SUPERMEMORY_DEBUG=true # Optional: enable debug loggingGlobal 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 |
License
MIT
Install & Usage
mkdir -p .claude/skillsmkdir -p .claude/skills && curl -o .claude/skills/claude-supermemory.md https://raw.githubusercontent.com/supermemoryai/claude-supermemory/main/SKILL.md/claude-supermemoryFrequently Asked Questions
What is claude-supermemory?
Persistent memory across Claude Code sessions using Supermemory
How to install claude-supermemory?
To install claude-supermemory, create the .claude/skills directory in your project, then run the curl command to download the skill file. Once installed, invoke it in Claude Code with /claude-supermemory.
What is claude-supermemory best for?
claude-supermemory is a community categorized under Development. Created by Supermemory.