grepmax 0.16.5 → 0.16.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md
CHANGED
|
@@ -60,8 +60,7 @@ gmax symbols auth # List indexed symbols
|
|
|
60
60
|
### Analysis Commands
|
|
61
61
|
|
|
62
62
|
```bash
|
|
63
|
-
gmax
|
|
64
|
-
gmax diff main --query "auth changes" # Semantic search within changes
|
|
63
|
+
gmax log src/lib/auth.ts # Git commit history for a path or symbol
|
|
65
64
|
gmax test handleAuth # Find tests via reverse call graph
|
|
66
65
|
gmax impact handleAuth # Dependents + affected tests
|
|
67
66
|
gmax similar handleAuth # Find similar code patterns
|
|
@@ -73,7 +72,6 @@ gmax context "auth system" --budget 4000 # Token-budgeted topic summary
|
|
|
73
72
|
```bash
|
|
74
73
|
gmax project # Languages, structure, key symbols
|
|
75
74
|
gmax related src/lib/auth.ts # Dependencies + dependents
|
|
76
|
-
gmax recent # Recently modified files
|
|
77
75
|
gmax status # All indexed projects + chunk counts
|
|
78
76
|
```
|
|
79
77
|
|
package/package.json
CHANGED
|
@@ -187,8 +187,10 @@ Understand:
|
|
|
187
187
|
gmax trace <symbol> call graph (--inbound = callers + snippets)
|
|
188
188
|
gmax test <symbol> tests for symbol
|
|
189
189
|
gmax impact <symbol> blast radius
|
|
190
|
+
gmax related <file> file deps + dependents
|
|
190
191
|
|
|
191
192
|
Survey:
|
|
193
|
+
gmax project codebase overview (langs, structure, key symbols)
|
|
192
194
|
gmax skeleton <file> file structure (file path, NOT a directory)
|
|
193
195
|
gmax context "topic" --budget 4000 multi-file topic summary
|
|
194
196
|
gmax log <path-or-symbol> git commits (replaces recent/diff)
|
|
@@ -196,7 +198,7 @@ Survey:
|
|
|
196
198
|
|
|
197
199
|
Scope flags: --root <name|path>, --in <subpath>, --exclude <subpath>.
|
|
198
200
|
Roles in results: [DEFI] [ORCH] [IMPL] [DOCS].
|
|
199
|
-
Recovery: "not added yet" → gmax add; stale
|
|
201
|
+
Recovery: "not added yet" → gmax add; stale → gmax index; broken → gmax doctor --fix.`,
|
|
200
202
|
},
|
|
201
203
|
};
|
|
202
204
|
process.stdout.write(JSON.stringify(response));
|
|
@@ -40,7 +40,7 @@ If search returns "This project hasn't been added to gmax yet", run `Bash(gmax a
|
|
|
40
40
|
|
|
41
41
|
### Search — `gmax "query" --agent`
|
|
42
42
|
|
|
43
|
-
The `--agent` flag produces compact, token-efficient output for AI agents. It
|
|
43
|
+
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`.
|
|
44
44
|
|
|
45
45
|
```
|
|
46
46
|
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
|
|
|
196
196
|
```
|
|
197
197
|
gmax status # show all indexed projects
|
|
198
198
|
gmax status --agent # compact: name\tchunks\tage\tstatus
|
|
199
|
-
gmax recent --agent # compact: path\tage
|
|
200
199
|
gmax related src/file.ts --agent # compact: dep:/rev: path\tcount
|
|
201
200
|
gmax project --agent # compact: key\tvalue pairs
|
|
202
201
|
gmax index # reindex current directory
|
|
203
202
|
gmax config # view/change settings
|
|
204
203
|
gmax doctor # health check
|
|
204
|
+
gmax doctor --fix # auto-repair (compact, prune, clear stale locks)
|
|
205
205
|
gmax llm on/off/start/stop/status # manage local LLM server
|
|
206
206
|
```
|
|
207
207
|
|
|
@@ -215,7 +215,7 @@ gmax llm on/off/start/stop/status # manage local LLM server
|
|
|
215
215
|
6. **Skeleton** — `Bash(gmax skeleton <path>)` before reading large files, or use `--skeleton` on search
|
|
216
216
|
7. **Read** — `Read file:line` for specific ranges identified by search/skeleton
|
|
217
217
|
8. **Trace** — `Bash(gmax trace <symbol>)` for deep call flow (multi-hop)
|
|
218
|
-
9. **
|
|
218
|
+
9. **Log** — `Bash(gmax log <path-or-symbol>)` for git commit history on a path or symbol
|
|
219
219
|
10. **Test** — `Bash(gmax test <symbol>)` to find tests covering a symbol before editing
|
|
220
220
|
11. **Impact** — `Bash(gmax impact <symbol>)` for blast radius before significant changes
|
|
221
221
|
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
|
|
|
225
225
|
|
|
226
226
|
## Tips
|
|
227
227
|
|
|
228
|
-
- **Use `--agent` for compact output** —
|
|
228
|
+
- **Use `--agent` for compact output** — works on most commands: search, peek, extract, trace, log, test, impact, similar, related, status, project, doctor.
|
|
229
229
|
- **Be specific.** 5+ words. "auth" returns noise. "where does the server validate JWT tokens" is specific.
|
|
230
230
|
- **Use `--role ORCHESTRATION`** to skip type definitions and find the actual logic.
|
|
231
231
|
- **Use `--symbol`** when the query is a function/class name — gets search + trace in one call.
|