Hooks Reference
April 1, 2026 ยท View on GitHub
| Hook | Trigger | Purpose |
|---|---|---|
namespace-hint | SessionStart | Inject plugin command namespace guidance into Claude context |
post-edit-format | After Edit/Write | Auto prettier + invalidate review state on edit |
post-tool-review-state | After Bash / MCP tools | Track review state (sentinel routing, supports namespaced commands) |
pre-edit-guard | Before Edit/Write | Prevent editing .env/.git |
stop-guard | Before stop | Block or warn on incomplete reviews + stale-state git check (strict after install, warn in plugin runtime) |
post-compact-auto-loop | After context compact | Re-inject auto-loop rules from state file |
post-skill-auto-loop | After Skill tool | Detect review/precommit gate sentinels and update state |
session-init | SessionStart (startup) | Initialize session state (drift sentinel, output style detection) |
user-prompt-review-guard | Before each prompt | Inject pending review reminder with cooldown (5min default) |
Hooks are safe by default. Use environment variables to customize:
| Variable | Default | Description |
|---|---|---|
STOP_GUARD_MODE | strict (installed) / warn (plugin runtime) | strict blocks stop on missing review steps; warn only warns |
HOOK_NO_FORMAT | (unset) | Set 1 to disable auto-formatting |
HOOK_BYPASS | (unset) | Set 1 to skip all stop-guard checks |
HOOK_DEBUG | (unset) | Set 1 to output debug info |
GUARD_EXTRA_PATTERNS | (unset) | Regex patterns for extra protected paths (e.g. src/locales/.*\.json$) |
REVIEW_GUARD_COOLDOWN | 300 (5 min) | Seconds between pending review reminders |
Dependencies: Hooks require jq. Auto-format requires prettier. Missing dependencies are handled gracefully.