Simple Memory Plugin for OpenCode

A persistent memory plugin for OpenCode that enables the AI assistant to remember context across sessions.

Setup

1. Add the plugin to your OpenCode config:

   {
   "$schema": "https://opencode.ai/config.json",
   "plugin": ["opencode-memory"]
   }

2. Start using memory commands in your conversations.

Memories are stored in ~/.config/opencode/memory/ as daily logfmt files.

Updating

Warning

OpenCode does NOT auto-update plugins.

To get the latest version, clear the cached plugin and let OpenCode reinstall it:

# Remove the plugin from cache
rm -rf ~/.cache/opencode/node_modules/opencode-memory
# Run OpenCode to trigger reinstall
opencode

Tools

The plugin provides five tools:

Tool	Description
memory_remember	Store a new memory
memory_recall	Retrieve memories by scope, type, or search query
memory_update	Update an existing memory
memory_forget	Delete a memory (with audit logging)
memory_list	List all scopes and types for discovery

Memory Types

• decision - Architectural or design decisions
• learning - Things learned during development
• preference - User or project preferences
• blocker - Current blockers or issues
• context - General context information
• pattern - Recurring patterns or conventions

Example Usage

User: Remember that my name is Kris
AI: [calls memory_remember with type="context", scope="user", content="User's name is Kris"]
I've stored that your name is Kris.
User: My preferred programming language is Erlang
AI: [calls memory_remember with type="preference", scope="user", content="Preferred programming language is Erlang"]
Got it! I've noted that your preferred programming language is Erlang.
User: What do you know about me?
AI: [calls memory_recall with scope="user"]
Here's what I know about you:
- Your name is Kris
- Your preferred programming language is Erlang
User: Actually, I prefer Elixir now.
AI: [calls memory_update with type="preference", scope="user", content="Preferred programming language is Elixir"]
Updated your language preference to Elixir.
User: Forget my language preference
AI: [calls memory_forget with type="preference", scope="user", reason="User requested removal"]
Done. I've removed your language preference from memory.

Local Development

Clone the repository and install dependencies:

git clone https://github.com/shuans/opencode-memory.git
cd opencode-memory
bun install

Point your OpenCode config to the local checkout via a file:// URL:

{
"$schema": "https://opencode.ai/config.json",
"plugin": ["file:///absolute/path/to/opencode-memory"]
}

Replace /absolute/path/to/opencode-memory with your actual path.