1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
|
---
title: "Claude Code"
sidebarTitle: "Claude Code"
description: "Claude Code Supermemory Plugin — persistent memory across coding sessions"
icon: "/images/claude-code-icon.svg"
---
<div className="w-1/2">
<img
src="/images/claude-code-supermemory.png"
alt="Claude Code + Supermemory"
className="rounded-lg shadow-lg"
/>
</div>
<Warning>
This integration requires the **Supermemory Pro plan**. [Upgrade here](https://console.supermemory.ai/billing).
</Warning>
[Claude-Supermemory](https://github.com/supermemoryai/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](https://console.supermemory.ai/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
| 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` |
## 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>
|