grepmax 0.7.34 → 0.7.36

package/README.md

@@ -125,6 +125,7 @@ gmax "how is the database connection pooled?"
 
 | Flag | Description | Default |
 | --- | --- | --- |
+| `--agent` | Ultra-compact output for AI agents (one line per result). | `false` |
 | `-m <n>` | Max total results to return. | `5` |
 | `--per-file <n>` | Max matches to show per file. | `3` |
 | `-c`, `--content` | Show full chunk content instead of snippets. | `false` |
@@ -148,13 +149,15 @@ gmax "how is the database connection pooled?"
 
 ```bash
 gmax "API rate limiting logic"
-gmax "auth handler" --role ORCHESTRATION --lang ts --plain
-gmax "database" --file syncer.ts --plain
-gmax "VectorDB" --symbol --plain
-gmax "error handling" -C 5 --imports
-gmax "handler" --name "handle.*" --exclude tests/
+gmax "auth handler" --role ORCHESTRATION --lang ts --agent
+gmax "database" --file syncer.ts --agent
+gmax "VectorDB" --symbol --agent
+gmax "error handling" -C 5 --imports --plain
+gmax "handler" --name "handle.*" --exclude tests/ --agent
 ```
 
+> **For AI agents:** Use `--agent` for the most token-efficient output (~90% fewer tokens than default). Output format: `file:line symbol [role] — summary`
+
 ### `gmax index`
 
 Index a directory into the centralized store.

package/dist/commands/search.js

@@ -345,6 +345,7 @@ exports.search = new commander_1.Command("search")
     .option("--imports", "Prepend file imports to each result", false)
     .option("--name <regex>", "Filter results by symbol name regex")
     .option("-C, --context <n>", "Include N lines before/after each result")
+    .option("--agent", "Ultra-compact output for AI agents (one line per result)", false)
     .argument("<pattern>", "Natural language query (e.g. \"where do we handle auth?\")")
     .argument("[path]", "Restrict search to this path prefix")
     .addHelpText("after", `
@@ -357,7 +358,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, _e;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
     const options = cmd.optsWithGlobals();
     const root = process.cwd();
     const minScore = Number.isFinite(Number.parseFloat(options.minScore))
@@ -451,8 +452,7 @@ Examples:
         process.env.GMAX_PROJECT_ROOT = projectRoot;
         vectorDb = new vector_db_1.VectorDB(paths.lancedbDir);
         // Check for active indexing lock and warn if present
-        // This allows agents (via shim) to know results might be partial.
-        if ((0, lock_1.isLocked)(paths.dataDir)) {
+        if (!options.agent && (0, lock_1.isLocked)(paths.dataDir)) {
             console.warn("⚠️  Warning: Indexing in progress... search results may be incomplete.");
         }
         const hasRows = yield vectorDb.hasAnyRows();
@@ -506,7 +506,7 @@ Examples:
                     stdio: "ignore",
                 });
             }
-            catch (_f) {
+            catch (_p) {
                 // Watcher may already be running — ignore
             }
         }
@@ -532,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 ((_e = searchResult.warnings) === null || _e === void 0 ? void 0 : _e.length) {
+        if (!options.agent && ((_e = searchResult.warnings) === null || _e === void 0 ? void 0 : _e.length)) {
             for (const w of searchResult.warnings) {
                 console.warn(`Warning: ${w}`);
             }
@@ -549,10 +549,65 @@ Examples:
                     return defs.some((d) => regex.test(d));
                 });
             }
-            catch (_g) {
+            catch (_q) {
                 // Invalid regex — skip
             }
         }
+        // Agent mode: ultra-compact one-line-per-result output
+        if (options.agent) {
+            if (!filteredData.length) {
+                console.log("(none)");
+            }
+            else {
+                for (const r of filteredData) {
+                    const absP = (_h = (_f = r.path) !== null && _f !== void 0 ? _f : (_g = r.metadata) === null || _g === void 0 ? void 0 : _g.path) !== null && _h !== void 0 ? _h : "";
+                    const relPath = absP.startsWith(effectiveRoot)
+                        ? absP.slice(effectiveRoot.length + 1)
+                        : absP;
+                    const startLine = Math.max(1, ((_m = (_k = (_j = r.startLine) !== null && _j !== void 0 ? _j : r.start_line) !== null && _k !== void 0 ? _k : (_l = r.generated_metadata) === null || _l === void 0 ? void 0 : _l.start_line) !== null && _m !== void 0 ? _m : 0) + 1);
+                    const defs = Array.isArray(r.defined_symbols)
+                        ? r.defined_symbols
+                        : [];
+                    const symbol = defs[0] || "";
+                    const role = ((_o = r.role) !== null && _o !== void 0 ? _o : "")
+                        .slice(0, 4)
+                        .toUpperCase();
+                    const summary = r.summary
+                        ? ` — ${r.summary}`
+                        : "";
+                    const sym = symbol ? ` ${symbol}` : "";
+                    const rl = role ? ` [${role}]` : "";
+                    console.log(`${relPath}:${startLine}${sym}${rl}${summary}`);
+                }
+            }
+            // Agent trace (compact)
+            if (options.symbol && vectorDb && filteredData.length > 0) {
+                try {
+                    const { GraphBuilder } = yield Promise.resolve().then(() => __importStar(require("../lib/graph/graph-builder")));
+                    const builder = new GraphBuilder(vectorDb);
+                    const graph = yield builder.buildGraphMultiHop(pattern, 1);
+                    if (graph.center) {
+                        console.log("---");
+                        for (const t of graph.callerTree) {
+                            const rel = t.node.file.startsWith(effectiveRoot)
+                                ? t.node.file.slice(effectiveRoot.length + 1)
+                                : t.node.file;
+                            console.log(`<- ${t.node.symbol} ${rel}:${t.node.line + 1}`);
+                        }
+                        for (const c of graph.callees.slice(0, 10)) {
+                            if (c.file) {
+                                const rel = c.file.startsWith(effectiveRoot)
+                                    ? c.file.slice(effectiveRoot.length + 1)
+                                    : c.file;
+                                console.log(`-> ${c.symbol} ${rel}:${c.line + 1}`);
+                            }
+                        }
+                    }
+                }
+                catch (_r) { }
+            }
+            return;
+        }
         if (options.skeleton) {
             yield outputSkeletons(filteredData, projectRoot, parseInt(options.m, 10), vectorDb);
             return;
@@ -634,7 +689,7 @@ Examples:
                     console.log(lines.join("\n"));
                 }
             }
-            catch (_h) {
+            catch (_s) {
                 // Trace failed — skip silently
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.34",
+  "version": "0.7.36",
   "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.34",
+  "version": "0.7.36",
   "description": "Semantic code search for Claude Code. Automatically indexes your project and provides intelligent search capabilities.",
   "author": {
     "name": "Robert Owens",

package/plugins/grepmax/hooks/start.js

@@ -89,7 +89,7 @@ async function main() {
     hookSpecificOutput: {
       hookEventName: "SessionStart",
       additionalContext:
-        'gmax ready. PREFER CLI over MCP tools — use Bash(gmax "query" --plain) for search, Bash(gmax trace <symbol>) for call graphs, Bash(gmax skeleton <path>) for file structure. CLI is 2x more token-efficient than MCP tool calls. Always add --plain flag.',
+        'gmax ready. PREFER CLI over MCP — use Bash(gmax "query" --agent) for search (one line per result, 89% fewer tokens). Bash(gmax trace <symbol>) for call graphs. Bash(gmax skeleton <path>) for structure. Always use --agent flag.',
     },
   };
   process.stdout.write(JSON.stringify(response));

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

@@ -13,29 +13,29 @@ Semantic code search — finds code by meaning, not just strings.
 
 ## IMPORTANT: Use CLI, not MCP tools
 
-**Always prefer `Bash(gmax ...)` over MCP tool calls.** The CLI is ~2x more token-efficient because MCP tool schemas add ~800 tokens of overhead per call. The CLI has full feature parity with every MCP tool.
+**Always prefer `Bash(gmax ...)` over MCP tool calls.** Use `--agent` for the most token-efficient output (one line per result, ~89% fewer tokens than default).
 
 ```
-Bash(gmax "auth handler" --role ORCHESTRATION --lang ts --plain -m 3)
+Bash(gmax "auth handler" --role ORCHESTRATION --lang ts --agent -m 3)
 ```
 
-**Only use MCP tools** for `index_status` (quick health check) or `summarize_directory` (LLM summaries). For everything else, use CLI.
+**Only use MCP tools** for `index_status` or `summarize_directory`. For everything else, use CLI with `--agent`.
 
 ## CLI commands (use these)
 
-### Search — `gmax "query" --plain`
+### Search — `gmax "query" --agent`
 ```
-gmax "where do we handle authentication" --plain
-gmax "database connection pooling" --role ORCHESTRATION --plain -m 5
-gmax "error handling" --lang ts --exclude tests/ --plain
-gmax "VectorDB" --symbol --plain          # search + call graph in one shot
-gmax "handler" --name "handle.*" --plain   # regex filter on symbol names
-gmax "auth" --file handler.ts --plain      # filter by filename
-gmax "query" -C 5 --plain                  # include context lines
-gmax "query" --imports --plain             # show file imports
+gmax "where do we handle authentication" --agent
+gmax "database connection pooling" --role ORCHESTRATION --agent -m 5
+gmax "error handling" --lang ts --exclude tests/ --agent
+gmax "VectorDB" --symbol --agent          # search + call graph in one shot
+gmax "handler" --name "handle.*" --agent   # regex filter on symbol names
+gmax "auth" --file handler.ts --agent      # filter by filename
 ```
 
-All flags: `--plain -m <n> --per-file <n> --min-score <n> --root <dir> --file <name> --exclude <prefix> --lang <ext> --role <role> --symbol --imports --name <regex> -C <n> --compact --content --scores --skeleton`
+Output format: `file:line symbol [role] — summary` (one line per result, no headers/footers)
+
+All flags: `--agent --plain -m <n> --per-file <n> --min-score <n> --root <dir> --file <name> --exclude <prefix> --lang <ext> --role <role> --symbol --imports --name <regex> -C <n> --compact --content --scores --skeleton`
 
 ### Trace — `gmax trace <symbol>`
 ```
@@ -78,7 +78,7 @@ gmax doctor                                # health check
 ## Workflow
 
 1. **Explore** — `Bash(gmax project)` for overview of a new codebase
-2. **Search** — `Bash(gmax "query" --plain)` to find code. Add `--symbol` for function/class names.
+2. **Search** — `Bash(gmax "query" --agent)` to find code. Add `--symbol` for function/class names.
 3. **Read** — `Read file:line` for specific ranges
 4. **Skeleton** — `Bash(gmax skeleton <path>)` before reading large files
 5. **Trace** — `Bash(gmax trace <symbol> -d 2)` for call flow
@@ -91,7 +91,7 @@ Use MCP only for `index_status` and `summarize_directory`. Use CLI for everythin
 
 ## Tips
 
-- **Always use `--plain`** on CLI searches — agent-friendly output without ANSI codes.
+- **Always use `--agent`** on CLI searches — one line per result, most token-efficient.
 - **Be specific.** 5+ words. "auth" returns noise. "where does the server validate JWT tokens" is specific.
 - **Use `--role ORCHESTRATION`** to skip type definitions and find the actual logic.
 - **Use `--symbol`** when the query is a function/class name — gets search + trace in one call.