Summary

This plugin addresses the lack of persistent memory for LLM agents within the OpenCode IDE. It enables agents to retain user preferences, project-specific knowledge, and conversation history across sessions and projects, significantly enhancing agent continuity and performance for developers.

How It Works

The plugin injects crucial context into agent prompts, including user profiles, project memories, and semantically relevant user memories, without explicit user commands. It automatically saves information based on keywords like "remember" or "save this," and can index entire codebases via the /supermemory-init command. To manage context window limits, it employs preemptive compaction, summarizing conversations and saving them as memories before the context is lost.

Quick Start & Requirements

Installation is straightforward using bunx opencode-supermemory@latest install. An API key from console.supermemory.ai is required, set via the SUPERMEMORY_API_KEY environment variable or a configuration file. For LLM agents, use bunx opencode-supermemory@latest install --no-tui. Users of Oh My OpenCode must disable the anthropic-context-window-limit-recovery hook in their configuration. Verification involves running opencode -c to confirm the supermemory tool is listed.

Highlighted Details

• Automatic context injection of user profile, project knowledge, and semantic memories.
• Keyword-driven memory saving (e.g., "remember this").
• Codebase exploration and memorization via /supermemory-init.
• Preemptive context compaction to preserve conversation history.
• add, search, profile, list, forget memory management tools.
• User-level (cross-project) and project-level memory scoping.
• Configurable via ~/.config/opencode/supermemory.jsonc for thresholds, memory limits, etc.

Maintenance & Community

No specific details regarding maintainers, community channels (like Discord/Slack), or project roadmap were present in the provided README.

Licensing & Compatibility

The project is released under the MIT license, which permits broad usage, including commercial applications and linking within closed-source projects.

Limitations & Caveats

Functionality is dependent on the OpenCode IDE and requires a valid Supermemory API key. Users integrating with Oh My OpenCode need to adjust specific hook configurations. The README does not detail known bugs or specific performance benchmarks beyond feature descriptions.