OpenCode Supermemory
https://github.com/supermemoryai/opencode-supermemory- Category
- AI Agents
- Rank
- No. 950Tools index
Previous survey · No. 957 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- supermemoryai
- GitHub
- 1.6k stars
- Date
About
Supermemory plugin for OpenCode — gives your coding agent persistent cross-session memory.
What it does
It adds a memory layer to OpenCode conversations. The plugin loads profile facts and project knowledge into the first message, asks the agent to consider recall on later turns, captures completed conversations, and reacts to explicit phrases such as “remember this.” Memories can be added, searched, listed, inspected, or forgotten.
Why it's ranked here
The design covers more than simple note storage. It joins automatic capture, selective recall, repository-aware scoping, privacy markers, and context compaction into one OpenCode integration. Stable capture identifiers prevent duplicate saves, while compatibility reads preserve knowledge from several older container schemes. The result is technically thoughtful, though dependent on external memory infrastructure.
What's good
Repository identity comes from the normalized Git remote, with a real-path fallback, so similarly named repositories stay separate. Personal and project records share a container but remain distinguishable through metadata. Synthetic context is excluded from captures, private-tagged text is redacted, and completed batches use stable identifiers to make repeated lifecycle events safe.
Tradeoffs
Authentication requires either a browser flow, an API key, or a local credentials file. Recall and storage depend on a Supermemory endpoint, so this is not an offline memory system. Automatic capture behavior also changes with installation state: fresh installs default to session-end capture, while existing configured installs receive periodic batches unless overridden.
How to use it well
It best suits developers who revisit the same repositories and want conventions, prior fixes, architecture notes, and communication preferences available across sessions. Initialize important codebases, mark secrets with private tags, and tune recall limits or capture cadence when needed. It does not replace source control, project documentation, issue tracking, or a general local knowledge base.
Technical notes+
src/index.ts registers the OpenCode chat, permission, event, and tool surfaces, injects first-message context, adds the per-turn recall directive, and wires capture plus compaction hooks. src/services/capture.ts removes synthetic and ignored parts, redacts private content, batches completed turns, and derives SHA-256 capture IDs. src/services/tags.ts hashes normalized Git origins or real repository paths and reads legacy Claude Code, Codex, OpenCode, and Cursor tags. src/config.ts resolves environment, JSONC, and saved credentials with environment keys taking precedence. src/services/client.ts uses the Supermemory package for hybrid search, profiles, writes, deletion, scoped metadata filters, response merging, and 30-second request timeouts. src/services/auth.ts runs a loopback browser callback with a random state token and stores credentials with restricted filesystem modes. package.json defines an ESM OpenCode plugin, a command-line binary, Bun builds, TypeScript declarations, type checking, and tests.
Observed
- License
- MIT
- Primary language
- TypeScript
- Packaging
- ES module package named opencode-supermemory; published files are limited to the dist directory.
- Installation surface
- Installed and managed through bunx commands for install, login, logout, and status.
- Interface
- OpenCode plugin with chat.message, permission.ask, and event hooks, plus a command-line binary.
- Agent tool
- Provides add, search, profile, list, forget, and help modes.
- Runtime integration
- Uses the Supermemory JavaScript package and supports configurable HTTP or HTTPS API endpoints.
Read from README.md, package.json, src/cli.ts, src/index.ts, src/config.ts, src/version.ts, src/types/index.ts, src/services/auth.ts, src/services/tags.ts, src/services/jsonc.ts, src/services/client.ts, src/services/logger.ts, src/services/recall.ts, src/services/capture.ts, src/services/context.ts.
What it can do
Store coding session data persistently
Code snippets, project context, and session information → Persistent memory storage for future retrieval
Retrieve previous coding context across sessions
Project identifiers or coding queries → Historical code context and previous session data
Maintain coding agent state between sessions
Agent configuration and learning data → Restored agent state with previous knowledge intact
Track code changes and development history
Code modifications and project evolution data → Comprehensive development timeline and change history
Enable context-aware code suggestions based on history
Current code context and stored session history → Personalized code recommendations based on past patterns
Tags
Tech Stack
Media
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.