opencode-codebase-index 0.13.1 → 0.13.2

package/.claude-plugin/marketplace.json

@@ -10,7 +10,7 @@
       "name": "codebase-index",
       "description": "Semantic code search and codebase graph tools for Claude Code",
       "source": "./",
-      "version": "0.13.1"
+      "version": "0.13.2"
     }
   ]
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codebase-index",
-  "version": "0.13.1",
+  "version": "0.13.2",
   "description": "Semantic code search and codebase graph tools for Claude Code",
   "displayName": "Codebase Index",
   "author": {

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "codebase-index",
-  "version": "0.13.1",
+  "version": "0.13.2",
   "description": "Semantic code search and codebase graph tools for Codex",
   "author": {
     "name": "Kenneth",

package/README.md

@@ -99,6 +99,15 @@ The plugin includes:
 - `.mcp.json` running the published `opencode-codebase-index` CLI via `npx … --host codex`, so a git marketplace install works without a local build
 - `.agents/plugins/marketplace.json` so this repo can act as a Codex marketplace source
 
+For local plugin development from this checkout, build and link the local MCP bin once:
+
+```bash
+npm run build:ts
+npm run dev:link-mcp
+```
+
+After that, the normal `.mcp.json` command also works when Codex starts the plugin from this repository.
+
 ## 🧩 Claude Code Plugin
 Install once for Claude Code sessions and get skill guidance plus MCP tools in one manifest.
 
@@ -155,7 +164,7 @@ Use the same semantic search from any MCP-compatible client. Index once, search
      "mcpServers": {
        "codebase-index": {
          "command": "npx",
-         "args": ["opencode-codebase-index-mcp", "--project", "/path/to/your/project"]
+         "args": ["-y", "--package", "opencode-codebase-index", "opencode-codebase-index-mcp", "--project", "/path/to/your/project"]
        }
      }
    }
@@ -167,7 +176,7 @@ Use the same semantic search from any MCP-compatible client. Index once, search
      "mcpServers": {
        "codebase-index": {
          "command": "npx",
-         "args": ["opencode-codebase-index-mcp", "--project", "/path/to/your/project"]
+         "args": ["-y", "--package", "opencode-codebase-index", "opencode-codebase-index-mcp", "--project", "/path/to/your/project"]
        }
      }
    }
@@ -175,14 +184,16 @@ Use the same semantic search from any MCP-compatible client. Index once, search
 
 3. **CLI options**
    ```bash
-   npx opencode-codebase-index-mcp --project /path/to/repo    # specify project root
-   npx opencode-codebase-index-mcp --config /path/to/config   # custom config file
-   npx opencode-codebase-index-mcp                            # uses current directory
+   npx -y --package opencode-codebase-index opencode-codebase-index-mcp --project /path/to/repo
+   npx -y --package opencode-codebase-index opencode-codebase-index-mcp --config /path/to/config
+   npx -y --package opencode-codebase-index opencode-codebase-index-mcp
    ```
 
 The MCP server exposes all 12 tools (`codebase_search`, `codebase_peek`, `find_similar`, `implementation_lookup`, `call_graph`, `call_graph_path`, `pr_impact`, `index_codebase`, `index_status`, `index_health_check`, `index_metrics`, `index_logs`) and 5 prompts (`search`, `find`, `definition`, `index`, `status`).
 
-The MCP dependencies (`@modelcontextprotocol/sdk`, `zod`) are optional peer dependencies — they're only needed if you use the MCP server.
+The MCP dependencies (`@modelcontextprotocol/sdk`, `zod`) ship with the package so published `npx --package opencode-codebase-index` launches work in clean MCP clients.
+
+If you are testing the MCP command from inside this repository checkout and see `opencode-codebase-index-mcp: command not found`, run `npm run build:ts && npm run dev:link-mcp`. That adds the local bin shim expected by `npx` without changing the published MCP config.
 
 ## 🔍 See It In Action
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-codebase-index",
-  "version": "0.13.1",
+  "version": "0.13.2",
   "description": "Semantic codebase indexing and search for OpenCode - find code by meaning, not just keywords",
   "type": "module",
   "main": "dist/index.js",
@@ -47,6 +47,7 @@
     "eval:ci": "npx tsx src/cli.ts eval run --reindex --ci --budget benchmarks/budgets/default.json --against benchmarks/baselines/eval-baseline-summary.json",
     "eval:ci:ollama": "npx tsx src/cli.ts eval run --config .github/eval-ollama-config.json --reindex --ci --budget benchmarks/budgets/default.json --against benchmarks/baselines/eval-baseline-summary.json",
     "eval:compare": "npx tsx src/cli.ts eval compare",
+    "dev:link-mcp": "node scripts/link-local-mcp-bin.mjs",
     "test": "vitest",
     "pretest:run": "node scripts/run-build-native-with-rustflags.mjs",
     "test:run": "vitest run",
@@ -61,6 +62,7 @@
     "native/*.node",
     "skill",
     "commands",
+    "scripts/link-local-mcp-bin.mjs",
     ".codex-plugin",
     ".claude-plugin",
     ".mcp.json",

package/scripts/link-local-mcp-bin.mjs

@@ -0,0 +1,25 @@
+import { existsSync, mkdirSync, rmSync, symlinkSync, writeFileSync } from "fs";
+import { dirname, relative, resolve } from "path";
+import { fileURLToPath } from "url";
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const cliPath = resolve(root, "dist/cli.js");
+const binDir = resolve(root, "node_modules/.bin");
+const binPath = resolve(binDir, "opencode-codebase-index-mcp");
+
+if (!existsSync(cliPath)) {
+  console.error("dist/cli.js is missing. Run `npm run build:ts` first.");
+  process.exit(1);
+}
+
+mkdirSync(binDir, { recursive: true });
+rmSync(binPath, { force: true });
+rmSync(`${binPath}.cmd`, { force: true });
+
+if (process.platform === "win32") {
+  writeFileSync(`${binPath}.cmd`, `@echo off\r\nnode "%~dp0\\..\\..\\dist\\cli.js" %*\r\n`, "utf-8");
+} else {
+  symlinkSync(relative(dirname(binPath), cliPath), binPath);
+}
+
+console.log(`Linked ${binPath} -> ${cliPath}`);