open-codebase-index 0.21.0-bootstrap.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,16 @@
+{
+  "name": "helweg-plugins",
+  "owner": {
+    "name": "Kenneth",
+    "email": "kenneth@example.com",
+    "url": "https://github.com/Helweg/opencode-codebase-index"
+  },
+  "plugins": [
+    {
+      "name": "codebase-index",
+      "description": "Semantic code search and codebase graph tools for Claude Code",
+      "source": "./",
+      "version": "0.21.0"
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,35 @@
+{
+  "name": "codebase-index",
+  "version": "0.21.0",
+  "description": "Semantic code search and codebase graph tools for Claude Code",
+  "displayName": "Codebase Index",
+  "author": {
+    "name": "Kenneth",
+    "email": "kenneth@example.com",
+    "url": "https://github.com/Helweg/opencode-codebase-index"
+  },
+  "homepage": "https://github.com/Helweg/opencode-codebase-index",
+  "repository": "https://github.com/Helweg/opencode-codebase-index",
+  "license": "MIT",
+  "keywords": [
+    "codebase-index",
+    "semantic search",
+    "claude",
+    "claude-code",
+    "mcp"
+  ],
+  "skills": "./skills/",
+  "mcpServers": {
+    "codebase-index": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "--package",
+        "open-codebase-index",
+        "open-codebase-index-mcp",
+        "--host",
+        "claude"
+      ]
+    }
+  }
+}

package/.codex-plugin/plugin.json

@@ -0,0 +1,43 @@
+{
+  "name": "codebase-index",
+  "version": "0.21.0",
+  "description": "Semantic code search and codebase graph tools for Codex",
+  "author": {
+    "name": "Kenneth",
+    "email": "kenneth@example.com",
+    "url": "https://github.com/Helweg/opencode-codebase-index"
+  },
+  "homepage": "https://github.com/Helweg/opencode-codebase-index",
+  "repository": "https://github.com/Helweg/opencode-codebase-index",
+  "license": "MIT",
+  "keywords": [
+    "codebase-index",
+    "semantic search",
+    "opencode",
+    "codex",
+    "mcp"
+  ],
+  "skills": "./skills/",
+  "hooks": "./hooks/hooks.json",
+  "id": "codebase-index",
+  "mcpServers": "./.mcp.json",
+  "interface": {
+    "displayName": "Codebase Index",
+    "shortDescription": "Navigate large codebases with semantic search and graph tools",
+    "longDescription": "Install this plugin to get semantic search tools in Codex. The skill layer gives usage guidance, and MCP tools provide searchable context for large repos.",
+    "developerName": "Kenneth",
+    "category": "Productivity",
+    "capabilities": [
+      "Instructions",
+      "MCP Tools",
+      "Search"
+    ],
+    "websiteURL": "https://github.com/Helweg/opencode-codebase-index",
+    "privacyPolicyURL": "https://github.com/Helweg/opencode-codebase-index/blob/main/SECURITY.md",
+    "termsOfServiceURL": "https://github.com/Helweg/opencode-codebase-index/blob/main/LICENSE",
+    "brandColor": "#3B82F6",
+    "defaultPrompt": [
+      "For repository questions, use index_status when readiness is unknown, then call codebase_context before shell search or broad file reads."
+    ]
+  }
+}

package/.mcp.json

@@ -0,0 +1,15 @@
+{
+  "mcpServers": {
+    "codebase-index": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "--package",
+        "open-codebase-index",
+        "open-codebase-index-mcp",
+        "--host",
+        "codex"
+      ]
+    }
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kenneth Helweg
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,235 @@
+# open-codebase-index
+
+[![npm version](https://img.shields.io/npm/v/open-codebase-index.svg)](https://www.npmjs.com/package/open-codebase-index)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Downloads](https://img.shields.io/npm/dm/open-codebase-index.svg)](https://www.npmjs.com/package/open-codebase-index)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/Helweg/opencode-codebase-index/ci.yml?branch=main)](https://github.com/Helweg/opencode-codebase-index/actions)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20-brightgreen.svg)](https://nodejs.org/)
+
+> Search a codebase by meaning, then follow the result into definitions, callers, and dependency paths.
+
+`open-codebase-index` is a local semantic code index for OpenCode, Jcode, Pi, Codex, Claude Code, and other MCP clients. It combines embeddings, BM25 keyword search, branch-aware filtering, symbol lookup, and a call graph behind agent-friendly tools.
+
+New installs should use `open-codebase-index` and `open-codebase-index-mcp`. The legacy package `opencode-codebase-index` and `opencode-codebase-index-mcp` remain supported aliases.
+
+## Highlights
+
+- **Semantic and hybrid retrieval** for questions where you do not know the identifier.
+- **Low-token discovery** through `codebase_context` and `codebase_peek`.
+- **Definition and graph navigation** through `implementation_lookup`, `call_graph`, and `call_graph_path`.
+- **Incremental, branch-aware indexing** with file watching and content-hash reuse.
+- **Local storage** backed by SQLite, usearch vectors, and a BM25 inverted index.
+- **Multiple embedding providers**: Ollama, GitHub Copilot, OpenAI, Google, or a custom OpenAI-compatible endpoint.
+- **Native parsing** for TypeScript/TSX, JavaScript/JSX, Python, Rust, Swift, Go, Java, C#, Ruby, C/C++, Metal, PHP, Apex, Bash, Zig, GDScript, MATLAB, JSON, TOML, YAML, Markdown, and HTML, with text fallback.
+
+## Quick start with OpenCode
+
+Requires Node.js 20 or newer.
+
+1. Install the package:
+
+   ```bash
+   npm install open-codebase-index
+   ```
+
+   Legacy installs continue to work with:
+
+   ```bash
+   npm install opencode-codebase-index
+   ```
+
+2. Add it to `opencode.json`:
+
+   ```json
+   {
+     "plugin": ["open-codebase-index"]
+   }
+   ```
+
+   Legacy alias:
+
+   ```json
+   {
+     "plugin": ["opencode-codebase-index"]
+   }
+   ```
+
+3. Run `/status`, then `/index`.
+4. Ask a repository question, for example:
+
+   > Where is authentication state validated before an API request?
+
+The first index creates embeddings. Later runs reuse unchanged content and process only relevant changes.
+
+## Choose your host
+
+| Host | Recommended integration | Storage |
+|---|---|---|
+| OpenCode | Native plugin | `.opencode/` |
+| Jcode | Per-session MCP server | `.codebase-index/` |
+| Pi | Pi package | `.codebase-index/` |
+| Codex | Marketplace plugin with MCP and skill guidance | `.codebase-index/` |
+| Claude Code | Marketplace plugin with MCP and skill guidance | `.claude/` |
+| Cursor, Windsurf, other MCP clients | `open-codebase-index-mcp` (legacy alias: `opencode-codebase-index-mcp`) | Selected by `--host`; default is OpenCode-compatible |
+
+See [Installation and host setup](docs/installation.md) for complete instructions.
+
+## Recommended workflow
+
+1. **Check readiness** with `index_status` or `/status`.
+2. **Index when needed** with `index_codebase` or `/index`.
+3. **Start repository discovery** with `codebase_context`.
+4. **Use `codebase_peek`** when you only need likely locations.
+5. **Use `implementation_lookup`** for a known symbol or definition question.
+6. **Use `codebase_search`** when you need full matching source content.
+7. **Use `grep`** for exact identifiers or exhaustive text matches.
+8. **Use call-graph tools** for callers, callees, and dependency paths.
+
+### Which search tool should I use?
+
+| Need | Tool |
+|---|---|
+| Route a repository question to a bounded evidence pack | `codebase_context` |
+| Find likely files and symbols without source bodies | `codebase_peek` |
+| Retrieve full matching code | `codebase_search` |
+| Find an authoritative definition | `implementation_lookup` |
+| Find analogous implementations or duplicates | `find_similar` |
+| Find direct callers or callees | `call_graph` |
+| Find a path between two symbols | `call_graph_path` |
+| Analyze a branch or pull request blast radius | `pr_impact` |
+
+See [Tools and commands](docs/tools.md) for host availability, tool details, MCP prompts, and slash commands.
+
+## How it works
+
+```text
+source files
+   │
+   ├─ file discovery and git-aware change detection
+   ├─ tree-sitter parsing and semantic chunking
+   ├─ embedding generation and content-hash reuse
+   ▼
+SQLite metadata + usearch vectors + BM25 index
+   │
+   ├─ semantic candidates
+   ├─ keyword candidates
+   ├─ branch and request filters
+   ├─ deterministic fusion and ranking
+   ▼
+locations, source results, definitions, and call-graph evidence
+```
+
+The TypeScript layer handles host integration, configuration, indexing orchestration, providers, ranking, and tools. The Rust NAPI module handles parsing, vector storage, SQLite operations, BM25 indexing, hashing, and call extraction.
+
+Read [Architecture](ARCHITECTURE.md) for the detailed data flow and design decisions.
+
+## Embedding providers
+
+With `embeddingProvider: "auto"`, providers are tried in this order:
+
+1. Ollama
+2. GitHub Copilot
+3. OpenAI
+4. Google
+
+Ollama is the simplest local option:
+
+```bash
+ollama pull nomic-embed-text
+```
+
+```json
+{
+  "embeddingProvider": "ollama"
+}
+```
+
+A custom OpenAI-compatible embeddings endpoint is also supported. Provider, indexing, search, reranking, include/exclude, knowledge-base, storage, and debug settings are documented in [Configuration](docs/configuration.md).
+
+## Configuration example
+
+OpenCode project config lives at `.opencode/codebase-index.json`. Codex, Pi, and Jcode use `.codebase-index/config.json`; Claude uses `.claude/codebase-index.json`.
+
+```json
+{
+  "embeddingProvider": "auto",
+  "scope": "project",
+  "indexing": {
+    "autoIndex": false,
+    "watchFiles": true,
+    "requireProjectMarker": true,
+    "semanticOnly": false
+  },
+  "search": {
+    "maxResults": 20,
+    "minScore": 0.1,
+    "fusionStrategy": "rrf",
+    "rerankTopN": 20
+  }
+}
+```
+
+Only specify values you want to override. See [Configuration](docs/configuration.md) for defaults and host-specific paths.
+
+## Branch-aware indexing
+
+The index stores reusable content by hash and maintains branch catalogs for chunks and symbols. On a branch switch, unchanged content can be reused while results remain scoped to the active branch. Linked worktrees without a local project config share the main checkout's portable project index; adding a worktree-local config creates an isolated index boundary.
+
+## Knowledge bases and reranking
+
+OpenCode and Pi can index additional directories as knowledge bases. Configure them with `knowledgeBases` or use the host-native knowledge-base tools where available.
+
+Optional external reranking supports Cohere, Jina, and custom compatible endpoints. Local filtering and evidence classes are applied before external candidates are submitted.
+
+See [Configuration](docs/configuration.md) for examples and privacy considerations.
+
+## Troubleshooting
+
+Start with:
+
+1. `/status` or `index_status`
+2. `index_health_check`
+3. a normal `/index` retry
+4. a forced rebuild only when status reports incompatibility or corruption
+
+Common provider, native module, stale index, branch, and performance issues are covered in [Troubleshooting](TROUBLESHOOTING.md).
+
+## Evaluation and performance
+
+The repository includes reproducible retrieval datasets, latency and quality budgets, baseline comparison, and cross-repository benchmarking tools.
+
+- [Evaluation harness](docs/evaluation.md)
+- [Cross-repository benchmarking](docs/benchmarking-cross-repo.md)
+
+Performance depends on repository size, parser coverage, provider latency, embedding cache reuse, and the selected indexing limits. Prefer measured evaluation over fixed marketing claims.
+
+## Development
+
+```bash
+npm ci
+npm run build
+npm run typecheck
+npm run lint
+npm run test:run
+```
+
+Native changes require Rust and `npm run build:native`. See [Contributing](CONTRIBUTING.md), [Architecture](ARCHITECTURE.md), and [Adding language support](docs/adding-language-support.md).
+
+## Documentation
+
+- [Installation and host setup](docs/installation.md)
+- [Tools and commands](docs/tools.md)
+- [Configuration](docs/configuration.md)
+- [Troubleshooting](TROUBLESHOOTING.md)
+- [Architecture](ARCHITECTURE.md)
+- [Evaluation](docs/evaluation.md)
+- [Cross-repository benchmarking](docs/benchmarking-cross-repo.md)
+- [Adding language support](docs/adding-language-support.md)
+- [Future `open-codebase-index` rename plan](docs/rename-to-open-codebase-index.md)
+- [Contributing](CONTRIBUTING.md)
+- [Security](SECURITY.md)
+- [Changelog](CHANGELOG.md)
+
+## License
+
+MIT. See [LICENSE](LICENSE).

package/THIRD_PARTY_LICENSES.md

@@ -0,0 +1,92 @@
+# Third-party licenses
+
+This file records third-party license notices added with their respective components. It does not claim to retroactively inventory every project dependency.
+
+## tree-sitter-php 0.24.2
+
+- Project: [tree-sitter/tree-sitter-php](https://github.com/tree-sitter/tree-sitter-php)
+- Source: [crate 0.24.2](https://crates.io/crates/tree-sitter-php/0.24.2)
+- License: MIT
+
+```text
+The MIT License (MIT)
+
+Copyright (c) 2017 Josh Vera, GitHub
+Copyright (c) 2019 Max Brunsfeld, Amaan Qureshi, Christian Frøystad, Caleb White
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## tree-sitter-swift 0.7.3
+
+- Project: [alex-pinkus/tree-sitter-swift](https://github.com/alex-pinkus/tree-sitter-swift)
+- Source: [tag 0.7.3](https://github.com/alex-pinkus/tree-sitter-swift/tree/0.7.3)
+- License: MIT
+
+```text
+MIT License
+
+Copyright (c) 2021 alex-pinkus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## unicode-case-folding 1.1.1
+
+- Project: [avivkeller/unicode-case-folding](https://github.com/avivkeller/unicode-case-folding)
+- Source: [npm package 1.1.1](https://www.npmjs.com/package/unicode-case-folding/v/1.1.1)
+- License: MIT
+
+```text
+Copyright 2025-Present Aviv Keller
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```

package/commands/call-graph.md

@@ -0,0 +1,29 @@
+---
+description: Trace callers, callees, or paths using the call graph
+---
+
+Trace function dependencies using the `call_graph` and `call_graph_path` tools.
+
+User input: $ARGUMENTS
+
+Interpret input as follows:
+- If input asks for a path, connection, route, chain, or "from X to Y", use `call_graph_path`.
+- Default to `direction="callers"` unless input asks for callees/calls/makes calls.
+- `name=<function>` or plain text function name sets `name`.
+- Unique names resolve automatically for both directions. Use optional `filePath=<path>` only when duplicate names are reported.
+- `symbolId=<id>` remains an optional backward-compatible escape hatch.
+- For path queries, parse `from=<function>`, `to=<function>`, and optional `maxDepth=<number>`.
+
+Execution flow:
+1. If input asks for a path and has source/target names, call `call_graph_path` with `{ from, to, maxDepth? }`.
+2. If direction is `callers`, call `call_graph` with `{ name, direction: "callers" }`.
+3. If direction is `callees`, call `call_graph` with `{ name, direction: "callees" }`.
+4. If the tool reports duplicate names, retry with the suggested `filePath`; for paths use `fromFilePath` or `toFilePath`.
+
+Examples:
+- `/call-graph Database` → callers for `Database`
+- `/call-graph callers name=Indexer` → callers for `Indexer`
+- `/call-graph callees name=Database filePath=src/database.ts` → callees for a duplicate name at that location
+- `/call-graph path from=createOrder to=chargeCard` → shortest known path between the two symbols
+
+If output says no callers found, suggest running `/index force` first.

package/commands/definition.md

@@ -0,0 +1,24 @@
+---
+description: Find where a symbol is defined in the codebase
+---
+
+Find the authoritative definition of a symbol in the codebase.
+
+User input: $ARGUMENTS
+
+The input is a symbol name or description of what to find the definition of.
+
+Look for optional parameters:
+- `limit=N` or "top N" → set limit
+- `dir=X` or "in folder X" → set directory filter
+- File extensions like ".ts", ".py" → set fileType
+
+Call `implementation_lookup` with the parsed arguments.
+
+Examples:
+- `/definition validateToken` → query="validateToken"
+- `/definition payment handler` → query="payment handler"
+- `/definition createSystem dir=packages/react` → query="createSystem", directory="packages/react"
+
+This prioritizes real implementation files over tests, docs, and examples.
+If no definition is found, suggest using `codebase_search` for broader discovery.

package/commands/find.md

@@ -0,0 +1,25 @@
+---
+description: Find code using hybrid approach (semantic + grep)
+---
+
+Find code using both semantic search and grep.
+
+User input: $ARGUMENTS
+
+Strategy:
+1. Use `codebase_search` to find semantically related code
+2. Identify specific function/class/variable names from results
+3. Use grep to find all occurrences of those identifiers
+4. Combine into a comprehensive answer
+
+Parse optional parameters from input:
+- `limit=N` → limit semantic results
+- `type=X` or "functions"/"classes" → filter chunk type
+- `dir=X` → filter directory
+
+Examples:
+- `/find error handling middleware`
+- `/find payment validation type=function`
+- `/find user auth in src/services`
+
+If no index exists, run `index_codebase` first.

package/commands/index.md

@@ -0,0 +1,27 @@
+---
+description: Index the codebase for semantic search
+---
+
+Run the `index_codebase` tool with these settings:
+
+User input: $ARGUMENTS
+
+Parse the input and set tool arguments:
+- force=true if input contains "force"
+- estimateOnly=true if input contains "estimate" 
+- verbose=false (default, for token efficiency)
+- verbose=true if input contains "verbose" (for detailed output)
+
+Examples:
+- `/index` → force=false, estimateOnly=false, verbose=false
+- `/index force` → force=true, estimateOnly=false, verbose=false
+- `/index estimate` → force=false, estimateOnly=true, verbose=false
+- `/index verbose` → force=false, estimateOnly=false, verbose=true
+
+IMPORTANT: You MUST pass the parsed arguments to `index_codebase`. Do not ignore them.
+
+Show final statistics including files processed, chunks indexed, tokens used, and duration.
+
+If indexing completes but the codebase still is not ready, tell the user to run `/status` next.
+- If `/status` reports failed embedding batches, fix the provider/auth issue and rerun `/index` normally.
+- Use `/index force` only for a full rebuild or when `/status` reports provider/model incompatibility.

package/commands/peek.md

@@ -0,0 +1,28 @@
+---
+description: Quickly find likely code locations without returning full code
+---
+
+Search the codebase using `codebase_peek`.
+
+User input: $ARGUMENTS
+
+The first part is the search query. Look for optional parameters:
+- `limit=N` or "top N" or "first N" → set limit
+- `type=X` or mentions "functions"/"classes"/"methods" → set chunkType
+- `dir=X` or "in folder X" → set directory filter
+- File extensions like ".ts", "typescript", ".py" → set fileType
+- `author=X` or `blameAuthor=X` → set blameAuthor filter
+- `sha=X` or `blameSha=X` → set blameSha filter
+- `since=YYYY-MM-DD` or `blameSince=YYYY-MM-DD` → set blameSince filter
+
+Call `codebase_peek` with the parsed arguments.
+
+Examples:
+- `/peek authentication logic` → query="authentication logic"
+- `/peek error handling limit=5` → query="error handling", limit=5
+- `/peek validation functions` → query="validation", chunkType="function"
+- `/peek auth logic author=jane@example.com since=2025-01-01` → query="auth logic", blameAuthor="jane@example.com", blameSince="2025-01-01"
+
+If the index doesn't exist, run `index_codebase` first.
+
+Return results as concise locations with file paths and line numbers. Suggest reading the returned files or using `codebase_search` when the user needs full code context.

package/commands/pr-impact.md

@@ -0,0 +1,23 @@
+---
+description: Analyze PR or branch impact using the call graph
+---
+
+Analyze the impact of a pull request or branch before merging.
+
+User input: $ARGUMENTS
+
+Interpret input as follows:
+- `pr=N` or plain number at the start → set `pr`
+- `branch=<name>` or plain branch name → set `branch`
+- `maxDepth=N` → set max traversal depth
+- `hubThreshold=N` → set hub node threshold
+- `checkConflicts` or `conflicts` → set `checkConflicts=true`
+
+Call `pr_impact` with the parsed arguments.
+
+Examples:
+- `/pr-impact 42` → pr=42
+- `/pr-impact branch=feature/auth` → branch="feature/auth"
+- `/pr-impact branch=feature/x maxDepth=3 checkConflicts` → branch="feature/x", maxDepth=3, checkConflicts=true
+
+If the index doesn't exist, run `index_codebase` first.

package/commands/reindex.md

@@ -0,0 +1,25 @@
+---
+description: Fully rebuild the codebase index from scratch
+---
+
+Run the `index_codebase` tool with `force=true` to rebuild the index from scratch.
+
+User input: $ARGUMENTS
+
+Parse the input and set tool arguments:
+- force=true always
+- estimateOnly=false always
+- verbose=false (default, for token efficiency)
+- verbose=true if input contains "verbose" (for detailed output)
+
+Examples:
+- `/reindex` → force=true, estimateOnly=false, verbose=false
+- `/reindex verbose` → force=true, estimateOnly=false, verbose=true
+
+IMPORTANT: You MUST call `index_codebase` with `force=true`.
+
+Show final statistics including files processed, chunks indexed, tokens used, and duration.
+
+If indexing completes but the codebase still is not ready, tell the user to run `/status` next.
+- If `/status` reports failed embedding batches, fix the provider/auth issue and rerun `/index` normally.
+- If `/status` reports provider/model incompatibility again after a rebuild, surface that clearly as an unexpected issue.