@memextend/opencode

> OpenCode adapter for memextend - Memory extension for AI coding agents

Status: ⚠️ Experimental/Untested - This adapter was developed based on OpenCode's MCP documentation but has not been tested in a production OpenCode environment. Community feedback and contributions are welcome!

This adapter provides memextend integration for OpenCode by Anomaly, an open-source AI coding agent.

Features

- MCP (Model Context Protocol) server for mid-session memory operations
- Search through past work and decisions
- Save important context and patterns
- Store global preferences across projects
- Semantic search using vector embeddings

Requirements

- Node.js 18+
- OpenCode installed (npm i -g opencode-ai)
- memextend CLI initialized (memextend init)

Installation

``bash

`Install the adapter`


npm install @memextend/opencode
Or if using the memextend monorepo

pnpm install
pnpm build


Configuration
$3

Add memextend to your global OpenCode configuration at ~/.config/opencode/opencode.json:

`json { "$schema": "https://opencode.ai/config.json", "mcp": { "memextend": { "type": "local", "command": ["node", "/path/to/node_modules/@memextend/opencode/dist/mcp/server.cjs"], "enabled": true } } }`

`$3`

Add to your project's opencode.json:

`json { "$schema": "https://opencode.ai/config.json", "mcp": { "memextend": { "type": "local", "command": ["node", "./node_modules/@memextend/opencode/dist/mcp/server.cjs"], "enabled": true } } }`

`$3`

If you have the package installed globally, you can reference it directly:

`json { "$schema": "https://opencode.ai/config.json", "mcp": { "memextend": { "type": "local", "command": ["npx", "@memextend/opencode", "mcp"], "enabled": true } } }`

`$3`

To find the correct path for your installation:

`bash

`If installed globally`


npm root -g
Then append: /@memextend/opencode/dist/mcp/server.cjs
If installed locally in a project

npm root
Then append: /@memextend/opencode/dist/mcp/server.cjs


Available MCP Tools
Once configured, the following tools are available in your OpenCode sessions:
$3
Search through your memories using semantic and full-text search.

`Use: Search for "authentication flow" or "Redis caching decisions"`

`$3`

Save a memory for the current project.

`Use: Save important decisions, patterns, or context for future reference`

`$3`

Save a global preference or fact that applies across all projects.

`Use: Save coding style preferences, common patterns, or personal facts Types: preference, pattern, fact`

`$3`

Delete a specific memory by ID.

`Use: Remove outdated or incorrect memories`

`$3`

Get memextend status and memory statistics.

`Use: Check how many memories are stored, database location, etc.`

`$3`

Get relevant context for the current session.

`Use: Retrieve recent memories, global preferences, and semantically related past work`

`Usage Examples`

After configuring memextend in your opencode.json, start OpenCode in your project:

`bash opencode`

Then interact with memextend through natural language:

`> Search my memories for authentication patterns

> Save this as a memory: We decided to use JWT tokens with 24-hour expiry for API authentication

> Remember globally that I prefer TypeScript with strict mode enabled

> What context do you have about this project?

> Show me the memextend status`

`Agent Instructions`

To give your agent memory guidance, copy the included AGENTS.md file to your project root or global config:

`bash

`Project-level (recommended)`


cp node_modules/@memextend/opencode/AGENTS.md AGENTS.md
Or global

cp node_modules/@memextend/opencode/AGENTS.md ~/.config/opencode/AGENTS.md

OpenCode automatically loads AGENTS.md files and includes them in the agent's context. The file contains instructions for when to search and save memories.

Note: OpenCode also falls back to CLAUDE.md if no AGENTS.md exists, so if you already have ~/.claude/CLAUDE.md from Claude Code, it will work automatically.

`How It Works`

1. MCP Integration: OpenCode connects to the memextend MCP server via stdio 2. Tool Discovery: OpenCode discovers the memextend tools at startup 3. Semantic Search: Memories are embedded using the Nomic embed model for semantic search 4. Hybrid Search: Combines vector similarity with full-text search for best results 5. Persistent Storage: Memories are stored in SQLite with sqlite-vec for vectors

`Configuration Reference`

`$3`

`typescript interface MCPConfig { type: 'local' | 'remote'; // 'local' for stdio servers command?: string[]; // Command and arguments to run environment?: Record; // Environment variables enabled?: boolean; // Enable/disable the server timeout?: number; // Request timeout in ms }`

`$3`

`json { "retrieval": { "autoInject": true, "maxMemories": 10, "recentDays": 7, "includeGlobal": true }, "capture": { "tools": ["Edit", "Write", "Bash", "Task"], "skipTools": ["Read", "Glob", "Grep"], "maxContentLength": 2000 } }`

`Differences from Claude Code Adapter`

| Feature | Claude Code | OpenCode | |---------|-------------|----------| | Hook System | Native hooks (SessionStart, Stop) | No native hooks | | Auto Context Injection | Yes (via SessionStart hook) | Manual via memextend_context | | Auto Memory Capture | Yes (via Stop hook) | Manual via memextend_save | | MCP Support | Yes | Yes | | Mid-Session Tools | Yes | Yes |

Since OpenCode does not have a native hook system like Claude Code, automatic context injection and memory capture are not available. Instead, users should:

1. Use memextend_contextat the start of a session to get relevant memories 2. Explicitly save important information usingmemextend_save or memextend_save_global

`Troubleshooting`

`$3`

If OpenCode cannot find the memextend MCP server:

1. Verify the path in your config is correct 2. Ensure the package is built:npm run build3. Check Node.js is in your PATH

`$3`

If searches return no results:

1. Run memextend initto initialize the database 2. Verify memextend is working:memextend status3. Save some test memories first

`$3`

If you see permission errors:

1. Ensure memextend directories exist: ~/.memextend/2. Check write permissions on the database files

`Development`

`bash

`Build the adapter`


npm run build
Run tests

npm test
Build only the MCP server bundle

npm run build:bundle

- memextend - Main memextend project
- OpenCode - OpenCode by Anomaly
- MCP Specification - Model Context Protocol

License

@memextend/opencode

> OpenCode adapter for memextend - Memory extension for AI coding agents

This adapter provides memextend integration for OpenCode by Anomaly, an open-source AI coding agent.

Features

Requirements

- Node.js 18+
- OpenCode installed (npm i -g opencode-ai)
- memextend CLI initialized (memextend init)

Installation

``bash

`Install the adapter`


npm install @memextend/opencode
Or if using the memextend monorepo

pnpm install
pnpm build


Configuration
$3

Add memextend to your global OpenCode configuration at ~/.config/opencode/opencode.json:

`$3`

Add to your project's opencode.json:

`json { "$schema": "https://opencode.ai/config.json", "mcp": { "memextend": { "type": "local", "command": ["node", "./node_modules/@memextend/opencode/dist/mcp/server.cjs"], "enabled": true } } }`

`$3`

If you have the package installed globally, you can reference it directly:

`json { "$schema": "https://opencode.ai/config.json", "mcp": { "memextend": { "type": "local", "command": ["npx", "@memextend/opencode", "mcp"], "enabled": true } } }`

`$3`

To find the correct path for your installation:

`bash

`If installed globally`


npm root -g
Then append: /@memextend/opencode/dist/mcp/server.cjs
If installed locally in a project

npm root
Then append: /@memextend/opencode/dist/mcp/server.cjs


Available MCP Tools
Once configured, the following tools are available in your OpenCode sessions:
$3
Search through your memories using semantic and full-text search.

`Use: Search for "authentication flow" or "Redis caching decisions"`

`$3`

Save a memory for the current project.

`Use: Save important decisions, patterns, or context for future reference`

`$3`

Save a global preference or fact that applies across all projects.

`Use: Save coding style preferences, common patterns, or personal facts Types: preference, pattern, fact`

`$3`

Delete a specific memory by ID.

`Use: Remove outdated or incorrect memories`

`$3`

Get memextend status and memory statistics.

`Use: Check how many memories are stored, database location, etc.`

`$3`

Get relevant context for the current session.

`Use: Retrieve recent memories, global preferences, and semantically related past work`

`Usage Examples`

After configuring memextend in your opencode.json, start OpenCode in your project:

`bash opencode`

Then interact with memextend through natural language:

`> Search my memories for authentication patterns

> Save this as a memory: We decided to use JWT tokens with 24-hour expiry for API authentication

> Remember globally that I prefer TypeScript with strict mode enabled

> What context do you have about this project?

> Show me the memextend status`

`Agent Instructions`

To give your agent memory guidance, copy the included AGENTS.md file to your project root or global config:

`bash

`Project-level (recommended)`


cp node_modules/@memextend/opencode/AGENTS.md AGENTS.md
Or global

cp node_modules/@memextend/opencode/AGENTS.md ~/.config/opencode/AGENTS.md

OpenCode automatically loads AGENTS.md files and includes them in the agent's context. The file contains instructions for when to search and save memories.

Note: OpenCode also falls back to CLAUDE.md if no AGENTS.md exists, so if you already have ~/.claude/CLAUDE.md from Claude Code, it will work automatically.

`How It Works`

`Configuration Reference`

`$3`

`Differences from Claude Code Adapter`

Since OpenCode does not have a native hook system like Claude Code, automatic context injection and memory capture are not available. Instead, users should:

1. Use memextend_contextat the start of a session to get relevant memories 2. Explicitly save important information usingmemextend_save or memextend_save_global

`Troubleshooting`

`$3`

If OpenCode cannot find the memextend MCP server:

1. Verify the path in your config is correct 2. Ensure the package is built:npm run build3. Check Node.js is in your PATH

`$3`

If searches return no results:

1. Run memextend initto initialize the database 2. Verify memextend is working:memextend status3. Save some test memories first

`$3`

If you see permission errors:

1. Ensure memextend directories exist: ~/.memextend/2. Check write permissions on the database files

`Development`

`bash

`Build the adapter`


npm run build
Run tests

npm test
Build only the MCP server bundle

npm run build:bundle

- memextend - Main memextend project
- OpenCode - OpenCode by Anomaly
- MCP Specification - Model Context Protocol

License

@memextend/opencode

@memextend/opencode

Features

Requirements

Installation

Install the adapter

Or if using the memextend monorepo

Configuration

$3

$3

$3

$3

If installed globally

Then append: /@memextend/opencode/dist/mcp/server.cjs

If installed locally in a project

Then append: /@memextend/opencode/dist/mcp/server.cjs

Available MCP Tools

$3

$3

$3

$3

$3

$3

Usage Examples

Agent Instructions

Project-level (recommended)

Or global

How It Works

Configuration Reference

$3

$3

Differences from Claude Code Adapter

Troubleshooting

$3

$3

$3

Development

Build the adapter

Run tests

Build only the MCP server bundle

Related

License

@memextend/opencode

@memextend/opencode

Features

Requirements

Installation

Install the adapter

Or if using the memextend monorepo

Configuration

$3

$3

$3

$3

If installed globally

Then append: /@memextend/opencode/dist/mcp/server.cjs

If installed locally in a project

Then append: /@memextend/opencode/dist/mcp/server.cjs

Available MCP Tools

$3

$3

$3

$3

$3

$3

Usage Examples

Agent Instructions

Project-level (recommended)

Or global

How It Works

Configuration Reference

$3

$3

Differences from Claude Code Adapter

Troubleshooting

$3

$3

$3

Development

Build the adapter

`Install the adapter`

`$3`

`$3`

`$3`

`If installed globally`

`$3`

`$3`

`$3`

`$3`

`$3`

`Usage Examples`

`Agent Instructions`

`Project-level (recommended)`

`How It Works`

`Configuration Reference`

`$3`

`$3`

`Differences from Claude Code Adapter`

`Troubleshooting`

`$3`

`$3`

`$3`

`Development`

`Build the adapter`

`Install the adapter`

`$3`

`$3`

`$3`

`If installed globally`

`$3`

`$3`

`$3`

`$3`

`$3`

`Usage Examples`

`Agent Instructions`

`Project-level (recommended)`

`How It Works`

`Configuration Reference`

`$3`

`$3`

`Differences from Claude Code Adapter`

`Troubleshooting`

`$3`

`$3`

`$3`

`Development`

`Build the adapter`