@khivi/opencode-codebase-index 0.5.2

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@khivi/opencode-codebase-index",
+  "version": "0.5.2",
+  "description": "Semantic codebase indexing and search for OpenCode - find code by meaning, not just keywords",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "bin": {
+    "opencode-codebase-index-mcp": "dist/cli.js",
+    "codebase-index": "dist/git-cli.js"
+  },
+  "license": "MIT",
+  "author": "Kenneth",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/khivi/opencode-codebase-index"
+  },
+  "keywords": [
+    "opencode",
+    "semantic-search",
+    "codebase-indexing",
+    "vector-search",
+    "embeddings",
+    "tree-sitter",
+    "ai-coding"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "npm run build:ts && npm run build:native",
+    "build:ts": "tsup",
+    "build:native": "cd native && cargo build --release && napi build --release --platform",
+    "build:native:all": "cd native && napi build --release --platform --target x86_64-apple-darwin --target aarch64-apple-darwin --target x86_64-unknown-linux-gnu --target aarch64-unknown-linux-gnu --target x86_64-pc-windows-msvc",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist",
+    "native/*.node",
+    "skill",
+    "commands"
+  ],
+  "napi": {
+    "binaryName": "codebase-index-native",
+    "targets": [
+      "x86_64-apple-darwin",
+      "aarch64-apple-darwin",
+      "x86_64-unknown-linux-gnu",
+      "aarch64-unknown-linux-gnu",
+      "x86_64-pc-windows-msvc"
+    ]
+  },
+  "dependencies": {
+    "chokidar": "^5.0.0",
+    "ignore": "^7.0.5",
+    "p-queue": "^9.1.0",
+    "p-retry": "^7.1.1",
+    "tiktoken": "^1.0.15"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@napi-rs/cli": "^3.5.1",
+    "@opencode-ai/plugin": "^1.1.21",
+    "@types/node": "^25.0.8",
+    "@vitest/coverage-v8": "^4.0.17",
+    "eslint": "^9.0.0",
+    "tsup": "^8.1.0",
+    "typescript": "^5.5.0",
+    "typescript-eslint": "^8.53.0",
+    "vitest": "^4.0.17",
+    "zod": "^3.25.67"
+  },
+  "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "@opencode-ai/plugin": "^1.0.0",
+    "zod": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
+    "@opencode-ai/plugin": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
+  }
+}

package/skill/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: codebase-search
+description: Semantic code search by meaning. Use codebase_peek to find WHERE code is (saves tokens), codebase_search to see actual code. For exact identifiers, use grep instead.
+---
+
+# Codebase Search Skill
+
+## When to Use What
+
+| Scenario | Tool | Why |
+|----------|------|-----|
+| Just need file locations | `codebase_peek` | Metadata only, saves ~90% tokens |
+| Need to see actual code | `codebase_search` | Returns full code content |
+| Find duplicates/patterns | `find_similar` | Given code snippet → similar code |
+| Understand code flow | `call_graph` | Find callers/callees of any function |
+| Don't know function/class names | `codebase_peek` or `codebase_search` | Natural language → code |
+| Know exact identifier names | `grep` | Faster, more precise |
+| Need ALL occurrences | `grep` | Semantic returns top N only |
+
+## Recommended Workflow
+
+1. **Locate with peek**: `codebase_peek("authentication flow")` → get file locations
+2. **Read what matters**: `Read` the specific files you need
+3. **Drill down with grep**: `grep "validateToken"` for exact matches
+
+## Tools
+
+### `codebase_peek`
+Find WHERE code is. Returns metadata only (file, line, name, type).
+
+```
+codebase_peek(query="validation logic", chunkType="function", directory="src/utils")
+```
+
+### `codebase_search`
+Find code with full content. Use when you need to see implementation.
+
+```
+codebase_search(query="error handling middleware", fileType="ts", contextLines=2)
+```
+
+### `find_similar`
+Find code similar to a given snippet. Use for duplicate detection, pattern discovery, refactoring.
+
+```
+find_similar(code="function validate(input) { return input.length > 0; }", excludeFile="src/current.ts")
+```
+
+### `call_graph`
+Query callers or callees of a function/method. Built automatically during indexing for TypeScript, JavaScript, Python, Go, and Rust.
+
+```
+call_graph(name="validateToken", direction="callers")
+call_graph(name="validateToken", direction="callees", symbolId="src/auth.ts::validateToken")
+```
+
+- `direction="callers"`: Who calls this function?
+- `direction="callees"`: What does this function call? (requires `symbolId` from a prior callers query)
+
+### `index_codebase`
+Manually trigger indexing. Required before first search. Incremental (~50ms when unchanged).
+
+### `index_status`
+Check if indexed and ready.
+
+## Query Tips
+
+**Describe behavior, not syntax:**
+- Good: `"function that hashes passwords securely"`
+- Bad: `"hashPassword"` (use grep for exact names)
+
+## Filters
+
+| Filter | Example |
+|--------|---------|
+| `chunkType` | `function`, `class`, `interface`, `type`, `method` |
+| `directory` | `"src/api"`, `"tests"` |
+| `fileType` | `"ts"`, `"py"`, `"rs"` |