grepmax 0.16.4 → 0.16.6

package/README.md

@@ -60,8 +60,7 @@ gmax symbols auth                       # List indexed symbols
 ### Analysis Commands
 
 ```bash
-gmax diff main                           # Changed files vs main
-gmax diff main --query "auth changes"    # Semantic search within changes
+gmax log src/lib/auth.ts                 # Git commit history for a path or symbol
 gmax test handleAuth                     # Find tests via reverse call graph
 gmax impact handleAuth                   # Dependents + affected tests
 gmax similar handleAuth                  # Find similar code patterns
@@ -73,7 +72,6 @@ gmax context "auth system" --budget 4000 # Token-budgeted topic summary
 ```bash
 gmax project                  # Languages, structure, key symbols
 gmax related src/lib/auth.ts  # Dependencies + dependents
-gmax recent                   # Recently modified files
 gmax status                   # All indexed projects + chunk counts
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grepmax",
-  "version": "0.16.4",
+  "version": "0.16.6",
   "author": "Robert Owens <78518764+reowens@users.noreply.github.com>",
   "homepage": "https://github.com/reowens/grepmax",
   "bugs": {

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

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

@@ -175,8 +175,30 @@ async function main() {
   const response = {
     hookSpecificOutput: {
       hookEventName: "SessionStart",
-      additionalContext:
-        'gmax ready. Use Bash(gmax "query" --agent) for search (one line per result, 89% fewer tokens). Bash(gmax extract <symbol>) for full function body. Bash(gmax peek <symbol>) for quick overview (sig+callers+callees). Bash(gmax trace <symbol>) for call graphs. Bash(gmax skeleton <path>) for structure. Bash(gmax diff [ref]) for git changes. Bash(gmax test <symbol>) for test coverage. Bash(gmax impact <symbol>) for blast radius. Bash(gmax similar <symbol>) for similar code. Bash(gmax context "topic" --budget 4000) for topic summary. Bash(gmax status) to check indexed projects. Role tags in results: [DEFI]=definition, [ORCH]=orchestration, [IMPL]=implementation, [DOCS]=docs. --agent flag works on search, trace, symbols, related, recent, status, project, extract, peek, diff, test, impact, similar. If search says "not added yet", run Bash(gmax add). If results look stale, run Bash(gmax index) to repair.',
+      additionalContext: `gmax ready. Add --agent to any command for compact output (~89% fewer tokens).
+
+Find:
+  gmax "topic"                       semantic search
+  gmax similar <symbol>              similar code
+
+Understand:
+  gmax peek <symbol>                 signature + callers + callees + tests
+  gmax extract <symbol>              full body + tests
+  gmax trace <symbol>                call graph (--inbound = callers + snippets)
+  gmax test <symbol>                 tests for symbol
+  gmax impact <symbol>               blast radius
+  gmax related <file>                file deps + dependents
+
+Survey:
+  gmax project                       codebase overview (langs, structure, key symbols)
+  gmax skeleton <file>               file structure (file path, NOT a directory)
+  gmax context "topic" --budget 4000 multi-file topic summary
+  gmax log <path-or-symbol>          git commits (replaces recent/diff)
+  gmax status                        indexed projects
+
+Scope flags: --root <name|path>, --in <subpath>, --exclude <subpath>.
+Roles in results: [DEFI] [ORCH] [IMPL] [DOCS].
+Recovery: "not added yet" → gmax add; stale → gmax index; broken → gmax doctor --fix.`,
     },
   };
   process.stdout.write(JSON.stringify(response));

package/plugins/grepmax/hooks/subagent-start.js

@@ -52,7 +52,7 @@ async function main() {
     hookSpecificOutput: {
       hookEventName: "SubagentStart",
       additionalContext:
-        'gmax semantic search is available. Use Bash(gmax "query" --agent) for concept search, Bash(gmax peek <symbol>) for overview, Bash(gmax extract <symbol>) for full body, Bash(gmax trace <symbol>) for call graph. If results look stale, run Bash(gmax index) to repair.',
+        'gmax available: gmax "query" --agent (search), gmax peek/extract/trace <symbol> --agent (symbol info / call graph). Stale results → gmax index.',
     },
   };
   process.stdout.write(JSON.stringify(response));

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

@@ -40,7 +40,7 @@ If search returns "This project hasn't been added to gmax yet", run `Bash(gmax a
 
 ### Search — `gmax "query" --agent`
 
-The `--agent` flag produces compact, token-efficient output for AI agents. It is supported on: `search`, `trace`, `symbols`, `related`, `recent`, `status`, and `project`.
+The `--agent` flag produces compact, token-efficient output for AI agents. It works on most commands — `search`, `peek`, `extract`, `trace`, `test`, `impact`, `similar`, `log`, `related`, `symbols`, `status`, `project`, `context`, `skeleton`, and `doctor`.
 
 ```
 gmax "where do we handle authentication" --agent
@@ -196,12 +196,12 @@ Agentic Q&A: a local LLM autonomously uses gmax tools (search, trace, peek, impa
 ```
 gmax status                                # show all indexed projects
 gmax status --agent                        # compact: name\tchunks\tage\tstatus
-gmax recent --agent                        # compact: path\tage
 gmax related src/file.ts --agent           # compact: dep:/rev: path\tcount
 gmax project --agent                       # compact: key\tvalue pairs
 gmax index                                 # reindex current directory
 gmax config                                # view/change settings
 gmax doctor                                # health check
+gmax doctor --fix                          # auto-repair (compact, prune, clear stale locks)
 gmax llm on/off/start/stop/status          # manage local LLM server
 ```
 
@@ -215,7 +215,7 @@ gmax llm on/off/start/stop/status          # manage local LLM server
 6. **Skeleton** — `Bash(gmax skeleton <path>)` before reading large files, or use `--skeleton` on search
 7. **Read** — `Read file:line` for specific ranges identified by search/skeleton
 8. **Trace** — `Bash(gmax trace <symbol>)` for deep call flow (multi-hop)
-9. **Diff** — `Bash(gmax diff [ref])` to see what changed and search within changes
+9. **Log** — `Bash(gmax log <path-or-symbol>)` for git commit history on a path or symbol
 10. **Test** — `Bash(gmax test <symbol>)` to find tests covering a symbol before editing
 11. **Impact** — `Bash(gmax impact <symbol>)` for blast radius before significant changes
 12. **Similar** — `Bash(gmax similar <symbol>)` to find similar patterns for DRY analysis
@@ -225,7 +225,7 @@ gmax llm on/off/start/stop/status          # manage local LLM server
 
 ## Tips
 
-- **Use `--agent` for compact output** — supported on search, trace, symbols, related, recent, status, project.
+- **Use `--agent` for compact output** — works on most commands: search, peek, extract, trace, log, test, impact, similar, related, status, project, doctor.
 - **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.