opencode-codebase-index

Codebase indexing plugin for OpenCode with hybrid keyword + vector search.

Install

bun install

Development checks

bun test
bun run typecheck
bun run lint

Storage backends

Configure the plugin in .opencode/codebase-index.json.

LanceDB (default)

{
  "storage": {
    "backend": "lancedb",
    "path": "./.opencode/codebase-index.lancedb"
  }
}

sqlite-vec (Bun)

{
  "storage": {
    "backend": "sqlite-vec",
    "path": "./.opencode/codebase-index.sqlite"
  }
}

Optional sqlite extension override:

{
  "storage": {
    "backend": "sqlite-vec",
    "path": "./.opencode/codebase-index.sqlite",
    "extensionPath": "/absolute/path/to/sqlite-vec-extension"
  }
}

Rebuild guidance

If storage schema or embedding dimensions change, rebuild the index:

index_rebuild --scope full

If you hit initialization errors like dimension/schema mismatch, remove the backend storage path and run a full rebuild.