---
title: "Hooks Reference"
description: "Complete reference for all 154 global lifecycle hook entries across 32 event categories."
canonical: "https://orchestkit.yonyon.ai/docs/reference/hooks"
---

# Hooks Reference

Complete reference for all 154 global lifecycle hook entries across 32 event categories.

# Hooks Reference

OrchestKit includes **154 global lifecycle hook entries** across **32 lifecycle event categories**, listed below by event. These are the *global* hooks that fire on Claude Code lifecycle events; agent- and skill-scoped hooks ship with their respective agents and skills, so the plugin's total hook count is higher than the number here.

| Category | Hooks | Description |
|----------|-------|-------------|
| [PreToolUse](/docs/reference/hooks/pre-tool-use) | 23 | Hooks for `PreToolUse` events |
| [PostToolUse](/docs/reference/hooks/post-tool-use) | 28 | Hooks for `PostToolUse` events |
| [PostToolBatch](/docs/reference/hooks/post-tool-batch) | 1 | Hooks for `PostToolBatch` events |
| [PostToolUseFailure](/docs/reference/hooks/post-tool-use-failure) | 2 | Hooks for `PostToolUseFailure` events |
| [PermissionRequest](/docs/reference/hooks/permission-request) | 4 | Hooks for `PermissionRequest` events |
| [UserPromptExpansion](/docs/reference/hooks/user-prompt-expansion) | 1 | Hooks for `UserPromptExpansion` events |
| [UserPromptSubmit](/docs/reference/hooks/user-prompt-submit) | 5 | Hooks for `UserPromptSubmit` events |
| [SessionStart](/docs/reference/hooks/session-start) | 20 | Hooks for `SessionStart` events |
| [CwdChanged](/docs/reference/hooks/cwd-changed) | 2 | Hooks for `CwdChanged` events |
| [FileChanged](/docs/reference/hooks/file-changed) | 2 | Hooks for `FileChanged` events |
| [DirectoryAdded](/docs/reference/hooks/directory-added) | 1 | Hooks for `DirectoryAdded` events |
| [SessionEnd](/docs/reference/hooks/session-end) | 7 | Hooks for `SessionEnd` events |
| [Stop](/docs/reference/hooks/stop) | 12 | Hooks for `Stop` events |
| [StopFailure](/docs/reference/hooks/stop-failure) | 2 | Hooks for `StopFailure` events |
| [SubagentStart](/docs/reference/hooks/subagent-start) | 3 | Hooks for `SubagentStart` events |
| [SubagentStop](/docs/reference/hooks/subagent-stop) | 6 | Hooks for `SubagentStop` events |
| [MessageDisplay](/docs/reference/hooks/message-display) | 1 | Hooks for `MessageDisplay` events |
| [Notification](/docs/reference/hooks/notification) | 3 | Hooks for `Notification` events |
| [PreCompact](/docs/reference/hooks/pre-compact) | 4 | Hooks for `PreCompact` events |
| [PostCompact](/docs/reference/hooks/post-compact) | 2 | Hooks for `PostCompact` events |
| [Elicitation](/docs/reference/hooks/elicitation) | 2 | Hooks for `Elicitation` events |
| [ElicitationResult](/docs/reference/hooks/elicitation-result) | 2 | Hooks for `ElicitationResult` events |
| [TeammateIdle](/docs/reference/hooks/teammate-idle) | 4 | Hooks for `TeammateIdle` events |
| [TaskCreated](/docs/reference/hooks/task-created) | 2 | Hooks for `TaskCreated` events |
| [TaskCompleted](/docs/reference/hooks/task-completed) | 2 | Hooks for `TaskCompleted` events |
| [WorktreeRemove](/docs/reference/hooks/worktree-remove) | 1 | Hooks for `WorktreeRemove` events |
| [PreModelSwitch](/docs/reference/hooks/pre-model-switch) | 2 | Hooks for `PreModelSwitch` events |
| [PostModelSwitch](/docs/reference/hooks/post-model-switch) | 2 | Hooks for `PostModelSwitch` events |
| [InstructionsLoaded](/docs/reference/hooks/instructions-loaded) | 2 | Hooks for `InstructionsLoaded` events |
| [ConfigChange](/docs/reference/hooks/config-change) | 2 | Hooks for `ConfigChange` events |
| [PermissionDenied](/docs/reference/hooks/permission-denied) | 2 | Hooks for `PermissionDenied` events |
| [Setup](/docs/reference/hooks/setup) | 2 | Hooks for `Setup` events |