jnzader-vault Hooks Recommendations
Hooks automatically run commands in response to Claude Code events. They're ideal for enforcement and automation that should happen consistently.
Note: These are common patterns. Use web search to find hooks for tools/frameworks not listed here to recommend the best hooks for the user.
Auto-Formatting Hooks
Prettier (JavaScript/TypeScript)
| Detection | File Exists |
|---|---|
.prettierrc, .prettierrc.json, prettier.config.js |
✓ |
Recommend: PostToolUse hook on Edit/Write to auto-format Value: Code stays formatted without thinking about it
ESLint (JavaScript/TypeScript)
| Detection | File Exists |
|---|---|
.eslintrc, .eslintrc.json, eslint.config.js |
✓ |
Recommend: PostToolUse hook on Edit/Write to auto-fix Value: Lint errors fixed automatically
Black/isort (Python)
| Detection | File Exists |
|---|---|
pyproject.toml with black/isort, .black, setup.cfg |
✓ |
Recommend: PostToolUse hook to format Python files Value: Consistent Python formatting
Ruff (Python - Modern)
| Detection | File Exists |
|---|---|
ruff.toml, pyproject.toml with [tool.ruff] |
✓ |
Recommend: PostToolUse hook for lint + format Value: Fast, comprehensive Python linting
gofmt (Go)
| Detection | File Exists |
|---|---|
go.mod |
✓ |
Recommend: PostToolUse hook to run gofmt Value: Standard Go formatting
rustfmt (Rust)
| Detection | File Exists |
|---|---|
Cargo.toml |
✓ |
Recommend: PostToolUse hook to run rustfmt Value: Standard Rust formatting
Type Checking Hooks
TypeScript
| Detection | File Exists |
|---|---|
tsconfig.json |
✓ |
Recommend: PostToolUse hook to run tsc --noEmit Value: Catch type errors immediately
mypy/pyright (Python)
| Detection | File Exists |
|---|---|
mypy.ini, pyrightconfig.json, pyproject.toml with mypy |
✓ |
Recommend: PostToolUse hook for type checking Value: Catch type errors in Python
Protection Hooks
Block Sensitive File Edits
| Detection | Presence Of |
|---|---|
.env, .env.local, .env.production |
Environment files |
credentials.json, secrets.yaml |
Secret files |
.git/ directory |
Git internals |
Recommend: PreToolUse hook that blocks Edit/Write to these paths Value: Prevent accidental secret exposure or git corruption
Block Lock File Edits
| Detection | Presence Of |
|---|---|
package-lock.json, yarn.lock, pnpm-lock.yaml |
JS lock files |
Cargo.lock, poetry.lock, Pipfile.lock |
Other lock files |
Recommend: PreToolUse hook that blocks direct edits Value: Lock files should only change via package manager
Test Runner Hooks
Jest (JavaScript/TypeScript)
| Detection | Presence Of |
|---|---|
jest.config.js, jest in package.json |
Jest configured |
__tests__/, *.test.ts, *.spec.ts |
Test files exist |
Recommend: PostToolUse hook to run related tests after edit Value: Immediate test feedback on changes
pytest (Python)
| Detection | Presence Of |
|---|---|
pytest.ini, pyproject.toml with pytest |
pytest configured |
tests/, test_*.py |
Test files exist |
Recommend: PostToolUse hook to run pytest on changed files Value: Immediate test feedback
Quick Reference: Detection → Recommendation
| If You See | Recommend This Hook |
|---|---|
| Prettier config | Auto-format on Edit/Write |
| ESLint config | Auto-lint on Edit/Write |
| Ruff/Black config | Auto-format Python |
| tsconfig.json | Type-check on Edit |
| Test directory | Run related tests on Edit |
| .env files | Block .env edits |
| Lock files | Block lock file edits |
| Go project | gofmt on Edit |
| Rust project | rustfmt on Edit |
Notification Hooks
Notification hooks run when Claude Code sends notifications. Use matchers to filter by notification type.
Permission Alerts
| Matcher | Use Case |
|---|---|
permission_prompt |
Alert when Claude requests permissions |
Recommend: Play sound, send desktop notification, or log permission requests Value: Never miss permission prompts when multitasking
Idle Notifications
| Matcher | Use Case |
|---|---|
idle_prompt |
Alert when Claude is waiting for input (60+ seconds idle) |
Recommend: Play sound or send notification when Claude needs attention Value: Know when Claude is ready for your input
Example Configuration
{
"hooks": {
"Notification": [
{
"matcher": "permission_prompt",
"hooks": [
{
"type": "command",
"command": "afplay /System/Library/Sounds/Ping.aiff"
}
]
},
{
"matcher": "idle_prompt",
"hooks": [
{
"type": "command",
"command": "osascript -e 'display notification \"Claude is waiting\" with title \"Claude Code\"'"
}
]
}
]
}
}
Available Matchers
| Matcher | Triggers When |
|---|---|
permission_prompt |
Claude needs permission for a tool |
idle_prompt |
Claude waiting for input (60+ seconds) |
auth_success |
Authentication succeeds |
elicitation_dialog |
MCP tool needs input |
Quick Reference: Detection → Recommendation
| If You See | Recommend This Hook |
|---|---|
| Prettier config | Auto-format on Edit/Write |
| ESLint config | Auto-lint on Edit/Write |
| Ruff/Black config | Auto-format Python |
| tsconfig.json | Type-check on Edit |
| Test directory | Run related tests on Edit |
| .env files | Block .env edits |
| Lock files | Block lock file edits |
| Go project | gofmt on Edit |
| Rust project | rustfmt on Edit |
| Multitasking workflow | Notification hooks for alerts |
Hook Placement
Hooks go in .claude/settings.json:
.claude/
└── settings.json ← Hook configurations here
Recommend creating the .claude/ directory if it doesn't exist.