OpenCode plugin that gives coding agents persistent memory using Supermemory
npm install @supermemory/opencodeOpenCode plugin for persistent memory using Supermemory.
``bash`
npx @supermemory/opencode setup
Interactive wizard that:
1. Installs plugin globally
2. Creates /supermemory-init command
3. Adds plugin to OpenCode config
Then set your API key:
`bash`
export SUPERMEMORY_API_KEY="your-api-key" # from console.supermemory.ai
On first message, injects:
- User profile (cross-project preferences)
- Project memories (all project knowledge)
- Relevant user memories (semantic search)
`
[SUPERMEMORY]
User Profile:
- Prefers concise responses
- Expert in TypeScript
Project Knowledge:
- [100%] Uses Bun, not Node.js
- [100%] Build: bun run build
Relevant Memories:
- [82%] Build fails if .env.local missing
`
Say "remember", "save this", "don't forget" etc. and the agent auto-saves to memory.
`
You: "Remember that this project uses bun"
Agent: [saves to project memory]
Run /supermemory-init to explore and memorize your codebase structure, patterns, and conventions.
When context hits 80% capacity:
1. Triggers OpenCode's summarization
2. Injects project memories into summary context
3. Saves session summary as a memory
This preserves conversation context across compaction events.
`
API key is
Content in tags is never stored.
The supermemory tool is available to the agent:
| Mode | Args | Description |
|------|------|-------------|
| add | content, type?, scope? | Store memory |search
| | query, scope? | Search memories |profile
| | query? | View user profile |list
| | scope?, limit? | List memories |forget
| | memoryId, scope? | Delete memory |
Scopes: user (cross-project), project (default)
Types: project-config, architecture, error-solution, preference, learned-pattern, conversation
| Scope | Tag | Persists |
|-------|-----|----------|
| User | opencode_user_{sha256(git email)} | All projects |opencode_project_{sha256(directory)}
| Project | | This project |
Create ~/.config/opencode/supermemory.jsonc:
`jsonc`
{
// API key (can also use SUPERMEMORY_API_KEY env var)
"apiKey": "sm_...",
// Min similarity for memory retrieval (0-1)
"similarityThreshold": 0.6,
// Max memories injected per request
"maxMemories": 5,
// Max project memories listed
"maxProjectMemories": 10,
// Max profile facts injected
"maxProfileItems": 5,
// Include user profile in context
"injectProfile": true,
// Prefix for container tags
"containerTagPrefix": "opencode"
}
All fields optional. Env var SUPERMEMORY_API_KEY takes precedence over config file.
API timeout: 5s
Registered in package.json:chat.message
- - Context injection on first message, keyword detectionevent
- - Compaction monitoring and summary capture
`bash`
bun install
bun run build
bun run typecheck
Local install:
`jsonc`
{
"plugin": ["file:///path/to/opencode-supermemory"]
}
`bash``
tail -f ~/.opencode-supermemory.log
MIT