opencodekit 0.19.4 → 0.19.6

package/dist/template/.opencode/skill/tilth-cli/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: tilth-cli
 description: AST-aware code navigation via tilth CLI. Use when subagents need structural code search, smart file reading, or codebase mapping — complements MCP tilth (which only the main agent can access).
-version: 1.1.0
+version: 2.0.0
 tags: [code-navigation, search, subagent]
 dependencies: []
 ---
@@ -58,20 +58,31 @@ Output: numbered lines (`N  content`). Large files get a structural outline; use
 ```bash
 npx -y tilth initCommand --scope src/           # Find definition + all usages
 npx -y tilth handleAuth --scope src/auth/       # Scoped to subdirectory
+npx -y tilth "sym1,sym2" --scope src/            # Multi-symbol search (max 5)
 ```
 
 Returns: definitions first (with expanded source), then usages with context lines.
 
-### 3. Search for Text
+### 3. Search for Text / Regex
 
 ```bash
 npx -y tilth "TODO" --scope src/                # Literal text search
 npx -y tilth "version" --scope src/             # Finds all occurrences
+npx -y tilth --kind content "config" --scope src/  # Explicit content search
+npx -y tilth --kind regex "/TODO.*fix/" --scope src/  # Regex search
 ```
 
-tilth auto-detects text vs symbol. Identifiers (camelCase, snake_case) → symbol search. Multi-word or quoted strings → text search.
+tilth auto-detects text vs symbol. Identifiers (camelCase, snake_case) → symbol search. Multi-word or quoted strings → text search. Use `--kind` to force a specific search mode.
 
-### 4. List Files (Glob)
+### 4. Find Callers
+
+```bash
+npx -y tilth --kind callers initCommand --scope src/  # Find all call sites
+```
+
+Uses SIMD-accelerated pre-filtering + tree-sitter AST parsing. More accurate than text grep for finding actual function calls vs. comments/strings.
+
+### 5. List Files (Glob)
 
 ```bash
 npx -y tilth "*.test.ts" --scope src/           # List test files
@@ -80,27 +91,37 @@ npx -y tilth "*.ts" --scope src/commands/       # List TS files in subdir
 
 Returns: matched file paths with token size estimates.
 
-### 5. Codebase Map (CLI-Only)
+### 6. Blast-Radius Analysis (Deps)
+
+```bash
+npx -y tilth --deps src/utils/errors.ts         # What imports this file + what it imports
+npx -y tilth --deps src/commands/init.ts --scope src/  # Scoped dependency check
+```
+
+Shows imports (local + external) AND what other files call its exports, with symbol-level detail. Use before renaming/removing exports.
+
+### 7. Codebase Map (CLI-Only)
 
 ```bash
 npx -y tilth --map --scope src/                 # Structural skeleton
 npx -y tilth --map --scope .                    # Whole project
 ```
 
-Returns: directory tree with exported symbols per file. **CLI-only** — not available in MCP mode.
+Returns: directory tree with exported symbols per file. **CLI-only** — deliberately excluded from MCP (agents overuse it).
 
 ## Available Flags
 
-| Flag                | Purpose                                | Example              |
-| ------------------- | -------------------------------------- | -------------------- |
-| `--scope <DIR>`     | Restrict search to directory           | `--scope src/`       |
-| `--section <RANGE>` | Line range or heading for file reads   | `--section 45-89`    |
-| `--full`            | Force full file content (skip outline) | `--full`             |
-| `--budget <N>`      | Max tokens in response                 | `--budget 2000`      |
-| `--json`            | Machine-readable JSON output           | `--json`             |
-| `--map`             | Generate codebase structure map        | `--map --scope src/` |
-
-**Note:** `--kind`, `--deps`, `--expand`, and multi-symbol comma syntax are MCP-only features. The CLI does not support them.
+| Flag                | Purpose                                  | Example                     |
+| ------------------- | ---------------------------------------- | --------------------------- |
+| `--scope <DIR>`     | Restrict search to directory             | `--scope src/`              |
+| `--section <RANGE>` | Line range or heading for file reads     | `--section 45-89`           |
+| `--full`            | Force full file content (skip outline)   | `--full`                    |
+| `--budget <N>`      | Max tokens in response                   | `--budget 2000`             |
+| `--json`            | Machine-readable JSON output             | `--json`                    |
+| `--map`             | Generate codebase structure map          | `--map --scope src/`        |
+| `--kind <TYPE>`     | Force search type: symbol/content/regex/callers | `--kind callers`     |
+| `--deps`            | Show blast-radius (imports + dependents) | `--deps src/file.ts`        |
+| `--expand <N>`      | Top N matches to show full source        | `--expand 3`                |
 
 ## MCP vs CLI Comparison
 
@@ -108,10 +129,10 @@ Returns: directory tree with exported symbols per file. **CLI-only** — not ava
 | ------------------------------------- | ---------------- | ------------------- |
 | Session dedup (`[shown earlier]`)     | Yes              | No                  |
 | Hash-anchored editing (`tilth_edit`)  | Yes              | No                  |
-| Blast-radius analysis (`tilth_deps`)  | Yes              | No                  |
-| Multi-symbol search (`sym1,sym2`)     | Yes              | No                  |
-| `--kind` flag (content/regex/callers) | Yes              | No                  |
-| `--expand` control                    | Yes              | No                  |
+| Blast-radius analysis (`--deps`)      | Yes              | Yes (v0.5.7+)       |
+| Multi-symbol search (`sym1,sym2`)     | Yes              | Yes (v0.5.7+)       |
+| `--kind` flag (content/regex/callers) | Yes              | Yes (v0.5.7+)       |
+| `--expand` control                    | Yes              | Yes (v0.5.7+)       |
 | `--map` codebase skeleton             | No               | Yes                 |
 | Subagent access                       | No (main only)   | Yes (any with Bash) |
 | Process overhead                      | Once (~17ms)     | Per call (~17ms)    |
@@ -161,6 +182,8 @@ utils/
 - **Use `--scope`** to narrow searches — avoids scanning irrelevant directories
 - **Use `--budget`** when you need concise output (limits token count)
 - **~17ms per call** — fast enough for interactive use, but avoid unnecessary repeated calls
+- **Use `--kind callers`** for precise call-site analysis instead of text grep
+- **Use `--deps`** before renaming or removing exports to check blast radius
 
 ## Example Subagent Dispatch
 
@@ -171,6 +194,10 @@ task({
 
 Find the definition of \`initCommand\` and understand how it's called:
   npx -y tilth initCommand --scope src/
+  npx -y tilth --kind callers initCommand --scope src/
+
+Check blast radius before editing:
+  npx -y tilth --deps src/commands/init.ts
 
 Then read the relevant file section:
   npx -y tilth src/commands/init.ts --section 515-600

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.19.4",
+	"version": "0.19.6",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"keywords": [
 		"agents",