v0.21.0 - Host-neutral package identity

What's New

Host-neutral package identity

open-codebase-index is now the preferred npm package. It ships the same implementation as opencode-codebase-index and exposes both open-codebase-index-mcp and opencode-codebase-index-mcp for compatibility.

The existing opencode-codebase-index package remains fully supported and continues to publish from the same release.

Portable project indexes

Project-owned paths are stored relative to the project root. Git worktrees that inherit project configuration can share the main checkout's index and reuse unchanged chunks and embeddings. Explicit worktree-local project configuration remains isolated.

Existing project indexes containing absolute stored paths require a one-time force rebuild.

Host-neutral architecture

OpenCode, MCP, and Pi registration now live behind dedicated adapters. Portable tool names are centralized, MCP CLI runtime is isolated behind its adapter, and host-dependent runtime paths require explicit host context. Existing tool names, schemas, outputs, and host-specific aliases are unchanged.

Compatibility-aware releases

Release automation stages metadata and manifests independently for both npm package identities, preserves native artifact names, and safely skips versions already published during retries.

Compatibility

• Existing opencode-codebase-index installs continue to work.
• Existing opencode-codebase-index-mcp commands continue to work.
• Storage paths, native artifact names, MCP server identity, and tool names are unchanged.
• New installations should prefer open-codebase-index.

Validation

• TypeScript and native builds
• Type checking and linting
• 1,273 Vitest tests
• 116 Rust tests
• macOS arm64/x64, Linux arm64/x64, and Windows x64 native builds
• Matching package inventories and both MCP binary aliases