@mem0/opencode-plugin

Persistent memory for OpenCode. Your agent remembers decisions, preferences, and learnings across sessions automatically.

Install

bash

opencode plugin @mem0/opencode-plugin

This adds the plugin to your ~/.config/opencode/opencode.json. The plugin registers its memory tools and skills itself — there is no MCP server to configure.

Or let your agent do it — paste this into OpenCode:

Install @mem0/opencode-plugin by following https://raw.githubusercontent.com/mem0ai/mem0/main/integrations/mem0-plugin/.opencode-plugin/README.md

Get your API key (free): app.mem0.ai/dashboard/api-keys

bash

echo 'export MEM0_API_KEY="m0-your-key"' >> ~/.zshrc && source ~/.zshrc

Restart OpenCode.

What's included

Component	Description
9 Native Memory Tools	`add_memory`, `search_memories`, `get_memories`, `update_memory`, `delete_memory`, and more — registered as OpenCode tools, backed by the `mem0ai` SDK (no MCP server required)
Lifecycle Hooks	Auto-search on session start and every prompt, error memory lookup, compaction context, secret redaction
9 Skills	`/mem0-remember`, `/mem0-tour`, `/mem0-search`, `/mem0-status`, `/mem0-scope`, `/mem0-dream`, `/mem0-forget`, `/mem0-pin`, `/mem0-context-loader` — discovered in place from the plugin via OpenCode's `skills.paths`

Hooks

Pure TypeScript — no Python, no shell scripts. Memory operations are native OpenCode tools backed by the mem0ai SDK directly.

Hook	Event	What it does
Config	`config`	Registers the `/mem0-*` slash commands (via `config.command`) and adds the plugin's own `opencode-skills/` dir to OpenCode's `skills.paths` for in-place skill discovery — no copying into `~/.config/opencode/skills`
Chat message	`chat.message`	Loads prior memories on session start, searches relevant memories before each prompt, auto-captures learnings periodically
Pre-tool	`tool.execute.before`	Blocks MEMORY.md writes, steering them to the `add_memory` tool
Post-tool	`tool.execute.after`	Scans bash errors and pre-fetches related memories
Messages transform	`experimental.chat.messages.transform`	Injects memory context (session memories, search results, error lookups) into the prompt
Compaction	`experimental.session.compacting`	Stores session state memory, then injects prior memories into compaction context so nothing is lost
Shell env	`shell.env`	Exports `MEM0_USER_ID`, `MEM0_APP_ID`, `MEM0_SESSION_ID`, and `MEM0_BRANCH` to shell

Memory Tools

Tool	Description
`add_memory`	Save text or conversation history
`search_memories`	Semantic search across memories
`get_memories`	List memories with filters and pagination
`get_memory`	Retrieve a specific memory by ID
`update_memory`	Overwrite a memory's text by ID
`delete_memory`	Delete a single memory by ID
`delete_all_memories`	Bulk delete all memories in scope
`delete_entities`	Delete an entity and its memories
`list_entities`	List users/agents/apps stored in Mem0

Memory scope

Every memory tool accepts an optional scope, and you can set the default scope (used when none is passed) with the /mem0-scope skill:

Scope	Reads	Writes
`project` (default)	this repo (`user_id` + `app_id`)	this repo
`session`	this run (adds `run_id`)	this run
`global`	all your projects (`app_id="*"`)	user-wide (drops `app_id`)

/mem0-scope            # show the current default scope
/mem0-scope global     # save & search across all your projects by default
/mem0-scope project    # back to repo-only (default)

The default persists in ~/.mem0/settings.json (default_scope) and is read fresh on each memory operation, so a change applies immediately — no restart. delete_all_memories always requires an explicit scope="global" to delete user-wide, so changing the default can't trigger a cross-project wipe.

Verify

Start OpenCode and ask: "Search my memories for recent decisions"

If the mem0 tools respond, you're all set.

Troubleshooting

Problem	Fix
No tools appearing	Restart OpenCode after installing
401 Unauthorized	`echo $MEM0_API_KEY` must print your `m0-` key
Plugin not loading	Run `opencode plugin @mem0/opencode-plugin` again

License

Apache-2.0