opencode-claude-mem

OpenCode plugin that gives claude-mem persistent memory to OpenCode sessions.

Records prompts, tool outputs, and injects relevant past context automatically.

Prerequisites

The claude-mem worker must be running on localhost (default port 37777).

Installation

Add to your opencode.jsonc:

{
  "plugin": [
    "opencode-claude-mem"
  ]
}

Or use a local path during development:

{
  "plugin": [
    "file:///path/to/opencode-claude-mem"
  ]
}

Configuration

Settings are resolved in order (first match wins):

| Priority | Source | Keys | |----------|--------|------| | 1 | Environment variable | OPENCODE_CLAUDE_MEM_WORKER_PORT, OPENCODE_CLAUDE_MEM_DEBUG_INJECT | | 2 | ~/.opencode-claude-mem/settings.json | Same as above | | 3 | ~/.claude-mem/settings.json | CLAUDE_MEM_WORKER_PORT (port only) | | 4 | Default | Port 37777 |

Architecture

OpenCode                          claude-mem worker (:37777)
  |                                      |
  |-- chat.message -----> POST /api/sessions/init
  |                        (records user prompt)
  |
  |-- tool.execute.after -> POST /api/sessions/observations
  |                        (records tool output)
  |
  |-- system.transform --> GET  /api/context/inject
                           (injects past context, cached 60s)

Development

bun run build    # Build dist/index.js
bun test         # Run unit tests

License

MIT