claude-supermemory

<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

Requires Node.js 18+ on your PATH — the memory hooks run as Node scripts.

/plugin marketplace add supermemoryai/claude-supermemory
/plugin install supermemory

Already have the old `claude-supermemory` plugin installed? It was renamed to supermemory, so it won't update in place. Migrate with:

```bash

/plugin marketplace update supermemory-plugins

/plugin install supermemory@supermemory-plugins

```

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

```bash

/plugin uninstall claude-supermemory@supermemory-plugins

```

Set 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

Configuration

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"]
}

Project Config — .claude/.supermemory-claude/config.json

Per-repo overrides. Run /supermemory:project-config or create manually:

{
  "apiKey": "sm_...",
  "baseUrl": "https://api.supermemory.ai",
  "repoContainerTag": "my-team-project",
  "signalExtraction": true
}

License

MIT