11---
22name : hooks-daemon
33description : Manage Claude Code Hooks Daemon - install, upgrade, check health, restart, and develop project-level handlers
4- argument-hint : " [install|upgrade|health|restart|check|dev-handlers|logs] [args...]"
4+ argument-hint : " [install|upgrade|health|restart|check|dev-handlers|regen-docs| logs|release-notes ] [args...]"
55disable-model-invocation : false
66user-invocable : true
77allowed-tools : Bash, Read, Write, Edit
@@ -48,6 +48,26 @@ The daemon caches config at startup — restart picks up any config or handler c
4848
4949See [ restart.md] ( restart.md ) for details.
5050
51+ ### Regenerate Generated Docs
52+
53+ Force-regenerate the daemon's generated documentation ** without restarting** :
54+
55+ ``` bash
56+ /hooks-daemon regen-docs
57+ ```
58+
59+ Rewrites both generated artifacts to their canonical form in one shot:
60+
61+ - ` .claude/HOOKS-DAEMON.md ` — the active-handler summary.
62+ - The ` <hooksdaemon> ` guidance block inside your project ` CLAUDE.md ` .
63+
64+ This is the explicit way to recover both files after a ** git merge/rebase conflict**
65+ left them stale or conflict-marked — run it, then stage the clean result. (A normal
66+ ` restart ` also refreshes these, but ` regen-docs ` does it as a one-shot with no daemon
67+ bounce.)
68+
69+ See [ regen-docs.md] ( regen-docs.md ) for details.
70+
5171### Check Health & Status
5272
5373Verify daemon is running correctly:
@@ -98,6 +118,24 @@ The report is saved to `./untracked/hooks-daemon-{description}.md` for sharing w
98118
99119See [ report.md] ( report.md ) for details.
100120
121+ ### Read Release Notes
122+
123+ Show the daemon's release notes without leaving the terminal. With no flag it
124+ shows the notes for the version you currently have installed:
125+
126+ ``` bash
127+ /hooks-daemon release-notes # installed version's notes
128+ /hooks-daemon release-notes --latest # newest available version
129+ /hooks-daemon release-notes --version 3.27.0 # a specific version
130+ /hooks-daemon release-notes --from 3.20.0 --to 3.27.0 # everything you gained upgrading
131+ /hooks-daemon release-notes --list # list available versions
132+ /hooks-daemon release-notes --version 3.27.0 --format json
133+ ```
134+
135+ Notes are read from the per-version ` RELEASES/vX.Y.Z.md ` files that ship with
136+ the install — no network access required. ` --from ` is exclusive and ` --to ` is
137+ inclusive, matching the upgrade semantics (the notes for everything you gained).
138+
101139## Quick Start
102140
103141After editing ` .claude/hooks-daemon.yaml ` :
@@ -165,7 +203,12 @@ case "$SUBCOMMAND" in
165203 cat " $SKILL_DIR /report.md" | sed " s/\$ ARGUMENTS/$* /"
166204 ;;
167205
168- logs|status|restart|handlers|validate-config|bug-report|check)
206+ regen-docs|regenerate-docs)
207+ # User-facing alias regen-docs maps to the CLI command regenerate-docs.
208+ bash " $SKILL_DIR /scripts/daemon-cli.sh" regenerate-docs " $@ "
209+ ;;
210+
211+ logs|status|restart|handlers|validate-config|bug-report|check|release-notes)
169212 # Forward to daemon CLI wrapper
170213 bash " $SKILL_DIR /scripts/daemon-cli.sh" " $SUBCOMMAND " " $@ "
171214 ;;
@@ -177,6 +220,7 @@ case "$SUBCOMMAND" in
177220 echo " Available commands:"
178221 echo " install [--force] Install daemon (fresh clone)"
179222 echo " restart Restart daemon (required after config changes)"
223+ echo " regen-docs Force-regenerate HOOKS-DAEMON.md + CLAUDE.md block"
180224 echo " health Check daemon health and status"
181225 echo " upgrade [VERSION] Upgrade daemon to new version"
182226 echo " dev-handlers Scaffold new project handlers"
@@ -186,6 +230,7 @@ case "$SUBCOMMAND" in
186230 echo " check Verbose environment & configuration audit"
187231 echo " bug-report DESC Generate bug report with diagnostics"
188232 echo " report DESC Investigate an issue and generate a detailed report"
233+ echo " release-notes [opts] Show release notes (installed version by default)"
189234 echo " "
190235 echo " After editing .claude/hooks-daemon.yaml, always run: /hooks-daemon restart"
191236 echo " "
0 commit comments