Loading image...
Apps
Enterprise
Pricing
Docs
Community
Resources
SIGN IN
DOWNLOADS
Loading image...
Docs
Features
Hooks
Troubleshooting
Copy page
View as Markdown
Troubleshooting hooks
Common issues
Hook not triggering
IDE
CLI
For file-related hooks, verify the file pattern matches your target files
Check that the hook is enabled (look for the eye icon in the Agent Hooks panel)
Ensure the event type is correct for what you're trying to automate
For Pre/Post Tool Use hooks, verify the tool name matches the tool being invoked
Unexpected hook behavior
Review the hook instructions for clarity
Check for conflicting hooks that may interfere with each other
Verify file patterns or tool matchers aren't too broad
Test the hook with a minimal case to isolate the issue
Performance issues
IDE
CLI
For file-related hooks, limit hook scope with more specific file patterns
For hooks with an agent prompt action, simplify any complex hook instructions
For hooks with a shell command action, ensure that the command completes quickly
Reduce the frequency of triggering events
Check that your timeout setting is appropriate (default: 60 seconds)
Shell command errors
Verify the command works when run manually in a terminal
Check that all required environment variables are available
Ensure any external tools or dependencies are installed
Review STDERR output for error messages
IDE
CLI
Check the Kiro output panel for hook execution logs
Page updated: August 4, 2026
Best practices
MCP
Troubleshooting hooks