opencode-cmem

OpenCode plugin for claude-mem — share persistent memory between Claude Code and OpenCode.

Both tools connect to the same worker (port 37777) and SQLite database (~/.claude-mem/claude-mem.db). Observations captured in Claude Code are searchable in OpenCode, and vice versa.

Prerequisites

• claude-mem installed via Claude Code marketplace
• Worker running: claude-mem worker start (or cd ~/.claude/plugins/marketplaces/thedotmack && npm run worker:start)
• Verify: curl http://127.0.0.1:37777/api/health

Install

Option A: Local plugin (quickest)

npm run local:install
# or manually:
cp src/index.ts ~/.config/opencode/plugins/claude-mem.ts

Restart OpenCode. Done.

Option B: npm plugin

bun install -g opencode-cmem

Then add the plugin to your OpenCode config (opencode.json in your project root):

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

Restart OpenCode. The plugin will automatically connect to the claude-mem worker on http://127.0.0.1:37777.

How it works

  ┌──────────────┐         ┌──────────────┐
  │  Claude Code  │         │   OpenCode   │
  │  (claude-mem  │         │  (opencode-  │
  │   hooks)      │         │   cmem)      │
  └──────┬───────┘         └──────┬───────┘
         │                        │
         │  POST /observations    │
         │  GET  /context/inject  │
         │  POST /summarize       │
         ▼                        ▼
  ┌──────────────────────────────────────┐
  │       claude-mem Worker :37777       │
  │       (localhost HTTP API)           │
  └──────────────┬───────────────────────┘
                 │
                 ▼
  ┌──────────────────────────────────────┐
  │  ~/.claude-mem/claude-mem.db (SQLite)│
  │  shared memory — both tools read &   │
  │  write to the same database          │
  └──────────────────────────────────────┘

Both Claude Code and OpenCode talk to the same worker over HTTP. The worker writes everything into a single SQLite database, so observations from one tool are immediately searchable in the other.

Hook lifecycle

Stage	Claude-mem hook	OpenCode hook	Worker API
1. SessionStart	context-hook.js	session.created + session.compacting	GET /api/context/inject
2. UserPrompt	new-hook.js	chat.message	tracks for summary
3. PostToolUse	save-hook.js	tool.execute.after	POST /api/sessions/observations
4. Stop	summary-hook.js	session.idle	POST /api/sessions/summarize
5. SessionEnd	cleanup-hook.js	session.idle	POST /api/sessions/complete

LLM tools

Tool	Description
claude_mem_search	Search past observations (with filters for type, date, concepts, files)
claude_mem_get_observations	Fetch full observation details by IDs
claude_mem_timeline	Recent session timeline (supports anchor-based view)
claude_mem_save	Manually save a memory
claude_mem_status	Worker health + stats

Config

Env variable	Default	Description
CLAUDE_MEM_WORKER_PORT	37777	Worker API port
CLAUDE_MEM_WORKER_URL	http://127.0.0.1:37777	Full worker URL (overrides port)
CLAUDE_MEM_LOG_LEVEL	info	Log level: error, warn, info, debug

Development

bun install
bun test
bun run build

Verify it works

1. Start the worker: claude-mem worker start
2. Install the plugin: npm run local:install
3. Restart OpenCode and do some work
4. Open http://localhost:37777 — you should see observations from OpenCode sessions
5. In Claude Code, search for those observations — they should appear

API reference

Based on claude-mem Platform Integration Guide.

Disclaimer

This project is not built by the OpenCode team and is not affiliated with Anomaly or the OpenCode project in any way.

License

MIT