opencode-readseek

OpenCode plugin for anchored edits, structural search, symbol navigation, and document inspection.

Install

For OpenCode with the legacy server plugin API, add the plugin to opencode.json:

{
  "plugin": ["opencode-readseek"]
}

For OpenCode V2, install the package locally:

npm install --save-dev opencode-readseek

Then select the isolated entrypoint in your project's opencode.json:

{
  "plugins": ["./node_modules/opencode-readseek/dist/v2.js"]
}

Local plugin modules can also import the default export from opencode-readseek/v2. This entrypoint does not load the legacy tool implementation. The existing opencode-readseek and opencode-readseek/server entrypoints remain unchanged.

The V2 entrypoint supplies a ReadSeek skill and agent guidance only; it does not register custom tools. The readseek_* tools listed below require the legacy server plugin API. To use the V2 skill, install @jarkkojs/readseek globally so readseek is on PATH; otherwise use OpenCode's built-in tools.

The plugin uses the AppImage on Linux (without FUSE) and native executables on macOS/Windows supplied by @jarkkojs/readseek. Set READSEEK_BINARY to an absolute executable path to override it.

Tools

readseek_inspect, readseek_extract, readseek_edit, readseek_write, readseek_grep, readseek_search, readseek_def, readseek_refs, and readseek_rename.

To control image handling:

{
  "plugin": [["opencode-readseek", { "imageMode": "auto" }]]
}

imageMode is auto (default), on, or off.

Development

bun install
bun test
bun run typecheck

Licensing

opencode-readseek is licensed under the Apache 2.0 license. See LICENSE for more information.