@hasna/hooks 0.3.11 → 0.4.0

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
@@ -26,6 +26,28 @@ hooks --help
26
26
  - `hooks doctor`
27
27
  - `hooks run`
28
28
 
29
+ ## Compact Output
30
+
31
+ CLI commands default to compact, agent-friendly output. List and search commands
32
+ show essential fields, cap terminal rows, and print hints for deeper inspection.
33
+ Use detail flags when you need more context:
34
+
35
+ ```bash
36
+ hooks list # compact, capped list
37
+ hooks list --all # show all rows
38
+ hooks list --verbose # include descriptions
39
+ hooks search git --limit 5 # cap result rows
40
+ hooks info gitguard # full metadata for one hook
41
+ hooks docs gitguard # README preview
42
+ hooks docs gitguard --verbose
43
+ hooks list --json # stable machine-readable full data
44
+ ```
45
+
46
+ MCP tools follow the same gradual disclosure pattern: list/search/log/profile
47
+ tools return compact summaries by default, while explicit flags such as
48
+ `compact:false`, `verbose:true`, or a detail tool like `hooks_info` return full
49
+ records.
50
+
29
51
  ## Codewith-native hooks
30
52
 
31
53
  @hasna/hooks includes unprefixed Codewith-native hook names: