OpenCode plugin for persistent memory using Supermemory.
Your agent remembers what you tell it - across sessions, across projects.
Installation
For Humans
bunx opencode-supermemory@latest install
Then get your API key from app.supermemory.ai and set it:
export SUPERMEMORY_API_KEY="sm_..."
Or let your agent do it - paste this into OpenCode:
Install opencode-supermemory by following https://raw.githubusercontent.com/supermemoryai/opencode-supermemory/main/README.md
For LLM Agents
Instructions for LLM Agents (click to expand)
If you're an LLM agent helping set up opencode-supermemory, follow these steps:
Step 1: Run the installer
bunx opencode-supermemory@latest install --no-tui
This will:
- Register the plugin in
~/.config/opencode/opencode.jsonc - Create the
/supermemory-initcommand
Step 2: Verify the config
cat ~/.config/opencode/opencode.jsoncShould contain:
{
"plugin": ["opencode-supermemory"]
}If not, add it manually:
JSONC:
JSON:
{
"plugin": ["opencode-supermemory"]
}Step 3: Configure API key
Ask the user to get their API key from app.supermemory.ai.
Then set it via environment variable:
export SUPERMEMORY_API_KEY="sm_..."
Or create ~/.config/opencode/supermemory.jsonc:
Step 4: Verify setup
Tell the user to restart OpenCode and run:
They should see supermemory in the tools list. If not, check:
- Is
SUPERMEMORY_API_KEYset? - Is the plugin in
opencode.jsonc? - Check logs:
tail ~/.opencode-supermemory.log
Step 5: Initialize codebase memory (optional)
Run /supermemory-init to have the agent explore and memorize the codebase.
Features
Context Injection
On first message, the agent receives (invisible to user):
- User profile (cross-project preferences)
- Project memories (all project knowledge)
- Relevant user memories (semantic search)
Example of what the agent sees:
[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
The agent uses this context automatically - no manual prompting needed.
Keyword Detection
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]
Add custom triggers via keywordPatterns config.
Codebase Indexing
Run /supermemory-init to explore and memorize your codebase structure, patterns, and conventions.
Preemptive Compaction
When context hits 80% capacity:
- Triggers OpenCode's summarization
- Injects project memories into summary context
- Saves session summary as a memory
This preserves conversation context across compaction events.
Privacy
API key is <private>sk-abc123</private>
Content in <private> tags is never stored.
Tool Usage
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
Memory Scoping
| Scope | Tag | Persists |
|---|---|---|
| User | opencode_user_{sha256(git email)} |
All projects |
| Project | opencode_project_{sha256(directory)} |
This project |
Configuration
Create ~/.config/opencode/supermemory.jsonc:
All fields optional. Env var SUPERMEMORY_API_KEY takes precedence over config file.
Container Tag Selection
By default, container tags are auto-generated using containerTagPrefix plus a hash:
- User tag:
{prefix}_user_{hash(git_email)} - Project tag:
{prefix}_project_{hash(directory)}
You can override this by specifying exact container tags:
This is useful when you want to:
- Share memories across team members (same
userContainerTag) - Sync memories between different machines for the same project
- Organize memories using your own naming scheme
- Integrate with existing Supermemory container tags from other tools
Usage with Oh My OpenCode
If you're using Oh My OpenCode, disable its built-in auto-compact hook to let supermemory handle context compaction:
Add to ~/.config/opencode/oh-my-opencode.json:
{
"disabled_hooks": ["anthropic-context-window-limit-recovery"]
}Development
bun install bun run build bun run typecheck
Local install:
Logs
tail -f ~/.opencode-supermemory.logLicense
MIT