grepmax 0.7.35 → 0.7.37

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.35",
+  "version": "0.7.37",
   "author": "Robert Owens <robowens@me.com>",
   "homepage": "https://github.com/reowens/grepmax",
   "bugs": {
@@ -23,6 +23,7 @@
   "files": [
     "dist",
     "plugins",
+    "scripts/postinstall.js",
     "mlx-embed-server",
     "README.md",
     "LICENSE",
@@ -62,6 +63,7 @@
     "vitest": "^1.6.1"
   },
   "scripts": {
+    "postinstall": "node scripts/postinstall.js",
     "prebuild": "mkdir -p dist",
     "build": "tsc",
     "postbuild": "chmod +x dist/index.js",

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

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.7.35",
+  "version": "0.7.37",
   "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

@@ -4,12 +4,13 @@ description: Semantic code search. Use alongside grep - grep for exact strings,
 allowed-tools: "mcp__grepmax__semantic_search, mcp__grepmax__code_skeleton, mcp__grepmax__trace_calls, mcp__grepmax__list_symbols, mcp__grepmax__index_status, mcp__grepmax__summarize_directory, mcp__grepmax__summarize_project, mcp__grepmax__related_files, mcp__grepmax__recent_changes, Bash(gmax:*), Read"
 ---
 
-## What gmax does
+## When to use what
 
-Semantic code search — finds code by meaning, not just strings.
-
-- grep/ripgrep: exact string match
-- gmax: concept match ("where do we handle auth?", "how does booking flow work?")
+- **Know the exact string/symbol?** → `Grep` tool (fastest, zero overhead)
+- **Know the file already?** → `Read` tool directly
+- **Searching by concept/behavior?** → `Bash(gmax "query" --agent)` (semantic search)
+- **Need file structure?** → `Bash(gmax skeleton <path>)`
+- **Need call flow?** → `Bash(gmax trace <symbol>)`
 
 ## IMPORTANT: Use CLI, not MCP tools
 
@@ -78,7 +79,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

package/scripts/postinstall.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * Postinstall: sync plugin files (SKILL.md, hooks, plugin.json) to
+ * the Claude Code plugin cache if it exists. This ensures `npm update -g grepmax`
+ * automatically updates the skill instructions without needing `gmax install-claude-code`.
+ */
+const fs = require("node:fs");
+const path = require("node:path");
+const os = require("node:os");
+
+const pluginCacheBase = path.join(os.homedir(), ".claude", "plugins", "cache", "grepmax", "grepmax");
+const sourcePlugin = path.join(__dirname, "..", "plugins", "grepmax");
+
+if (!fs.existsSync(pluginCacheBase) || !fs.existsSync(sourcePlugin)) {
+  // Plugin not installed via Claude Code — skip silently
+  process.exit(0);
+}
+
+// Find installed version directories
+let entries;
+try {
+  entries = fs.readdirSync(pluginCacheBase, { withFileTypes: true });
+} catch {
+  process.exit(0);
+}
+
+const versionDirs = entries.filter((e) => e.isDirectory()).map((e) => e.name);
+if (versionDirs.length === 0) process.exit(0);
+
+// Sync files to each installed version
+function copyRecursive(src, dest) {
+  if (!fs.existsSync(src)) return;
+  const stat = fs.statSync(src);
+  if (stat.isDirectory()) {
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src)) {
+      copyRecursive(path.join(src, entry), path.join(dest, entry));
+    }
+  } else {
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.copyFileSync(src, dest);
+  }
+}
+
+for (const ver of versionDirs) {
+  const destDir = path.join(pluginCacheBase, ver);
+  try {
+    // Sync skills
+    copyRecursive(
+      path.join(sourcePlugin, "skills"),
+      path.join(destDir, "skills"),
+    );
+    // Sync hooks
+    copyRecursive(
+      path.join(sourcePlugin, "hooks"),
+      path.join(destDir, "hooks"),
+    );
+    // Sync hooks.json
+    const hooksJson = path.join(sourcePlugin, "hooks.json");
+    if (fs.existsSync(hooksJson)) {
+      fs.copyFileSync(hooksJson, path.join(destDir, "hooks.json"));
+    }
+  } catch {
+    // Best-effort — don't fail the install
+  }
+}