apps/docs/integrations/claude-code.mdx
Claude-Supermemory is a Claude Code plugin that gives your AI persistent memory across sessions. Your agent remembers what you worked on — across sessions, across projects.
Create a Supermemory API key from the API Keys page, then add it to your shell profile so it persists across sessions:
<Tabs> <Tab title="macOS / Linux (zsh)"> ```bash echo 'export SUPERMEMORY_CC_API_KEY="sm_..."' >> ~/.zshrc source ~/.zshrc ``` </Tab> <Tab title="macOS / Linux (bash)"> ```bash echo 'export SUPERMEMORY_CC_API_KEY="sm_..."' >> ~/.bashrc source ~/.bashrc ``` </Tab> <Tab title="Windows (PowerShell)"> ```powershell [System.Environment]::SetEnvironmentVariable("SUPERMEMORY_CC_API_KEY", "sm_...", "User") ``` Restart your terminal after running this. </Tab> </Tabs># Add the plugin marketplace
/plugin marketplace add supermemoryai/claude-supermemory
# Install the plugin
/plugin install claude-supermemory
Once installed, the plugin runs automatically:
| Tool | Captured As |
|---|---|
| Edit | Edited src/auth.ts: "old code..." → "new code..." |
| Write | Created src/new-file.ts (500 chars) |
| Bash | Ran: npm test (SUCCESS/FAILED) |
| Task | Spawned agent: explore codebase |
Log out from Supermemory and clear saved credentials.
/claude-supermemory:logout
SUPERMEMORY_CC_API_KEY=sm_... # Required
SUPERMEMORY_SKIP_TOOLS=Read,Glob,Grep # Tools to not capture (optional)
SUPERMEMORY_DEBUG=true # Enable debug logging (optional)
Create ~/.supermemory-claude/settings.json:
{
"skipTools": ["Read", "Glob", "Grep", "TodoWrite"],
"captureTools": ["Edit", "Write", "Bash", "Task"],
"maxContextMemories": 10,
"maxProjectMemories": 20,
"debug": false
}