Back to Supermemory

Claude Code

apps/docs/integrations/claude-code.mdx

latest3.1 KB
Original Source
<div className="w-1/2"> </div> <Warning> This integration requires the **Supermemory Pro plan**. [Upgrade here](https://console.supermemory.ai/billing). </Warning>

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.

Get Your API Key

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>

Install the Plugin

bash
# Add the plugin marketplace
/plugin marketplace add supermemoryai/claude-supermemory

# Install the plugin
/plugin install claude-supermemory

How It Works

Once installed, the plugin runs automatically:

  • Context Injection — On session start, relevant memories are fetched and injected into Claude's context. This includes user preferences, project knowledge, and past interactions.
  • Auto-Capture — Tool usage is captured and stored during the session for future context.

What Gets Captured

ToolCaptured As
EditEdited src/auth.ts: "old code..." → "new code..."
WriteCreated src/new-file.ts (500 chars)
BashRan: npm test (SUCCESS/FAILED)
TaskSpawned agent: explore codebase

Commands

/claude-supermemory:logout

Log out from Supermemory and clear saved credentials.

/claude-supermemory:logout

Configuration

Environment Variables

bash
SUPERMEMORY_CC_API_KEY=sm_...         # Required
SUPERMEMORY_SKIP_TOOLS=Read,Glob,Grep # Tools to not capture (optional)
SUPERMEMORY_DEBUG=true                # Enable debug logging (optional)

Settings File

Create ~/.supermemory-claude/settings.json:

json
{
  "skipTools": ["Read", "Glob", "Grep", "TodoWrite"],
  "captureTools": ["Edit", "Write", "Bash", "Task"],
  "maxContextMemories": 10,
  "maxProjectMemories": 20,
  "debug": false
}

Next Steps

<CardGroup cols={2}> <Card title="GitHub Repository" icon="github" href="https://github.com/supermemoryai/claude-supermemory"> Source code, issues, and detailed README. </Card> <Card title="OpenClaw Plugin" icon="messages-square" href="/integrations/openclaw"> Multi-platform memory for Telegram, WhatsApp, Discord, and more. </Card> </CardGroup>