Your code is never stored. Processing exclusively in EU data centers. GDPR-compliant.
View our security standardsHooks & Event Automation
Automate your AI coding workflow with 10 event hooks. Run shell scripts or HTTP calls on SessionStart, PreToolUse, PostToolUse and more. GDPR-compliant.
11 Event Types
SessionStart/End, Pre/PostToolUse, and more, hook precisely into the lifecycle.
Command Hooks
Attach shell commands to events, lint, test, notify.
HTTP Hooks
Webhooks to internal or external services, CI, ChatOps, monitoring.
Plugin Hooks
Plugins react to the same events, extend without patching core.
Hook Validation
Validate configuration before it goes live, fewer surprises in production.
Hook Templates (/create-hook)
Quick start with `/create-hook`, boilerplate for common automation.
The 10 Hook Events
Every significant moment in the agent lifecycle has a corresponding hook event. Subscribe to one or many.
| Event | When | Use Case |
|---|---|---|
SessionStart | Session opens | Check environment, load secrets, notify team |
SessionEnd | Session closes | Summarize work, post summary to Slack |
PreToolUse | Before any tool call | Logging, rate limiting, input validation |
PostToolUse | After successful tool call | Audit trail, metrics, test runner |
PostToolUseFailure | After failed tool call | Alert, fallback, error reporting |
UserPromptSubmit | User sends a message | Input filtering, profanity guard |
SubagentStart | Subagent spawned | Resource tracking, cost monitoring |
Stop | Agent stops | Cleanup, git commit, deploy trigger |
PreCompact | Before context compaction | Save important context to file |
Notification | Agent sends notification | Route to preferred channel |
Create a Hook
Use /create-hook to scaffold a hook file. The AI generates the boilerplate for Shell or TypeScript hooks.
/create-hook PreToolUse my-loggerShell hook — runs before every tool call/create-hook PostToolUse audit --tsTypeScript hook — after every tool call/create-hook SessionEnd notifyHook runs when the session endsExample: Audit-Log Hook
Log every tool call to a file — useful for compliance, debugging, and tracking AI actions.
#!/bin/bash # .lurus/hooks/pre-tool-use.sh # Logs every tool call with timestamp echo "$(date -u +'%Y-%m-%dT%H:%M:%SZ') [TOOL] $TOOL_NAME $TOOL_INPUT" >> .lurus/audit.log