grepmax 0.7.23 → 0.7.24

package/dist/commands/search.js

@@ -357,7 +357,7 @@ Examples:
   gmax "handler" --name "handle.*" --exclude tests/
 `)
     .action((pattern, exec_path, _options, cmd) => __awaiter(void 0, void 0, void 0, function* () {
-    var _a, _b, _c, _d;
+    var _a, _b, _c, _d, _e;
     const options = cmd.optsWithGlobals();
     const root = process.cwd();
     const minScore = Number.isFinite(Number.parseFloat(options.minScore))
@@ -497,10 +497,23 @@ Examples:
                 throw e;
             }
         }
+        // Ensure a watcher is running for live reindexing
+        if (!process.env.VITEST && !((_c = process.env.NODE_ENV) === null || _c === void 0 ? void 0 : _c.includes("test"))) {
+            try {
+                const { execFileSync } = yield Promise.resolve().then(() => __importStar(require("node:child_process")));
+                execFileSync("gmax", ["watch", "-b", "--path", projectRoot], {
+                    timeout: 5000,
+                    stdio: "ignore",
+                });
+            }
+            catch (_f) {
+                // Watcher may already be running — ignore
+            }
+        }
         const searcher = new searcher_1.Searcher(vectorDb);
         // Use --root or fall back to project root
         const effectiveRoot = options.root
-            ? (_c = (0, project_root_1.findProjectRoot)(path.resolve(options.root))) !== null && _c !== void 0 ? _c : path.resolve(options.root)
+            ? (_d = (0, project_root_1.findProjectRoot)(path.resolve(options.root))) !== null && _d !== void 0 ? _d : path.resolve(options.root)
             : projectRoot;
         const searchPathPrefix = exec_path
             ? path.resolve(exec_path)
@@ -519,7 +532,7 @@ Examples:
         if (options.role)
             searchFilters.role = options.role;
         const searchResult = yield searcher.search(pattern, parseInt(options.m, 10), { rerank: true }, Object.keys(searchFilters).length > 0 ? searchFilters : undefined, pathFilter);
-        if ((_d = searchResult.warnings) === null || _d === void 0 ? void 0 : _d.length) {
+        if ((_e = searchResult.warnings) === null || _e === void 0 ? void 0 : _e.length) {
             for (const w of searchResult.warnings) {
                 console.warn(`Warning: ${w}`);
             }
@@ -536,7 +549,7 @@ Examples:
                     return defs.some((d) => regex.test(d));
                 });
             }
-            catch (_e) {
+            catch (_g) {
                 // Invalid regex — skip
             }
         }
@@ -621,7 +634,7 @@ Examples:
                     console.log(lines.join("\n"));
                 }
             }
-            catch (_f) {
+            catch (_h) {
                 // Trace failed — skip silently
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.23",
+  "version": "0.7.24",
   "author": "Robert Owens <robowens@me.com>",
   "homepage": "https://github.com/reowens/grepmax",
   "bugs": {

package/plugins/grepmax/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.23",
+  "version": "0.7.24",
   "description": "Semantic code search for Claude Code. Automatically indexes your project and provides intelligent search capabilities.",
   "author": {
     "name": "Robert Owens",

package/plugins/grepmax/skills/grepmax/SKILL.md

@@ -130,11 +130,31 @@ The watcher auto-starts when the MCP server connects — it detects file changes
 
 If search results include a warning like "Full-text search unavailable", results may be less precise. This resolves automatically — the index retries FTS every 5 minutes.
 
+## CLI vs MCP — when to use which
+
+**Prefer CLI (`Bash(gmax ...)`) for repeated searches.** The CLI is ~2x more token-efficient because MCP tool schemas add ~800 tokens of overhead per call. Every CLI flag maps to an MCP param:
+
+```
+Bash(gmax "auth handler" --role ORCHESTRATION --lang ts --plain -m 3)
+```
+
+is equivalent to `semantic_search` with `role: "ORCHESTRATION", language: "ts", limit: 3` — but costs half the tokens.
+
+**CLI commands for all MCP tools:**
+- `gmax "query" --plain` → `semantic_search`
+- `gmax trace <symbol> -d 2` → `trace_calls` with depth
+- `gmax skeleton <target> --json` → `code_skeleton`
+- `gmax project` → `summarize_project`
+- `gmax related <file>` → `related_files`
+- `gmax recent` → `recent_changes`
+
+**Use MCP tools when:** first exploring (tool descriptions guide usage), or when you need pointer mode output (more structured than CLI).
+
 ## Tips
 
 - **Be specific.** "auth" returns noise. "where does the server validate JWT tokens from the Authorization header" returns exactly what you need. Aim for 5+ words.
-- **ORCH results contain the logic** — prioritize over DEF/IMPL results.
+- **Use `--plain` for CLI searches** — agent-friendly output without ANSI codes.
+- **ORCH results contain the logic** — use `--role ORCHESTRATION` to filter noise.
 - **Summaries tell you what the code does** without reading it. Use them to decide what to `Read`.
-- **Use `root` for cross-project search** — absolute path to another indexed directory.
-- **Use `max_per_file`** when results cluster in one file but you need diversity.
+- **Use `--symbol` on CLI** to get search results + call graph in one shot.
 - **Don't search for exact strings** — use grep/Grep for that. gmax finds concepts, not literals.