Security Hooks Collection
Ready-made hooks for security and compliance.
Copy the entries you want from hooks/hooks.json into your
.claude/settings.json (or a plugin's hooks/hooks.json), then review them in /hooks.
What's included
| Hook | Event | Purpose |
|---|---|---|
| Config audit trail | ConfigChange | Appends every settings/skills change to ~/.claude/security-audit.log (JSONL) — compliance evidence. (#41) |
| Dangerous-bash guard | PreToolUse (Bash) | Prompt-hook that flags destructive shell commands before they run. |
| Sensitive-file write guard | PreToolUse (Write/Edit) | Warns on writes to credential/financial file patterns. |
| HTTP notify (optional) | ConfigChange / SessionEnd | POSTs a security event to a webhook (Slack/SIEM). Off until you set the URL. (#35) |
Install
# inspect the ready-made config
cat hooks/hooks.json
# merge the entries you want into your settings (review in /hooks afterwards)
# (the audit-trail command writes to ~/.claude/security-audit.log)
The ConfigChange event (v2.1.49) matches user_settings, project_settings,
local_settings, policy_settings, skills. HTTP hooks (v2.1.63) POST JSON and read a
JSON response. All hooks receive session_id, cwd, permission_mode, hook_event_name.
Security note: hooks run with your privileges. Review every entry before enabling; the command hook here only appends to a local log and never executes scanned content.