Skip to main content
This integration requires the Supermemory Pro plan. Upgrade here.
OpenCode-Supermemory is an OpenCode 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: 
echo 'export SUPERMEMORY_API_KEY="sm_..."' >> ~/.zshrc
source ~/.zshrc

​
Install the Plugin

bunx opencode-supermemory@latest install
For LLM agents (non-interactive): 
bunx opencode-supermemory@latest install --no-tui
Ensure your ~/.config/opencode/opencode.jsonc contains: 
{
  "plugin": ["opencode-supermemory"]
}

​
How It Works

Once installed, the plugin runs automatically:
  • Context Injection — On session start, relevant memories are fetched and injected into the agent’s context. This includes user preferences, project knowledge, and past interactions.
  • Keyword Detection — Phrases like “remember” or “save this” trigger automatic storage.
  • Smart Compaction — At 80% context capacity, sessions are summarized and saved as memories.
  • Privacy Protection — Content within <private> tags never persists.

​
Memory Scopes

ScopeDescription
userMemories that persist across all projects
projectMemories isolated to the current project (default)

​
Memory Types

TypeDescription
project-configProject configuration and setup details
architectureCodebase structure and design patterns
error-solutionProblems encountered and their fixes
preferenceUser preferences and coding style
learned-patternPatterns discovered during sessions
conversationImportant conversation context

​
Commands

​
/supermemory-init

Explore and index your codebase structure into memory: 
/supermemory-init

​
Tools

The agent has access to a supermemory tool with these modes:
ModeParametersFunction
addcontent, type?, scope?Store information
searchquery, scope?Find relevant memories
profilequery?View user preferences
listscope?, limit?Display stored items
forgetmemoryId, scope?Remove memory

​
Configuration

Create ~/.config/opencode/supermemory.jsonc: 
{
  "apiKey": "sm_...",              // Or use SUPERMEMORY_API_KEY env var
  "similarityThreshold": 0.6,      // Minimum match score (0-1)
  "maxMemories": 5,                // Memories per injection
  "maxProjectMemories": 10,        // Project memory listings
  "maxProfileItems": 5,            // Profile facts injected
  "injectProfile": true,           // Include user preferences in context
  "containerTagPrefix": "opencode", // Tag prefix for scoping
  "compactionThreshold": 0.80      // Context usage ratio for summarization
}

​
Logging

View plugin activity: 
tail -f ~/.opencode-supermemory.log

​
Next Steps

GitHub Repository

Source code, issues, and detailed README.

Claude Code Plugin

Memory plugin for Claude Code.