Automate actions with hooks changedhooks-guide
Recorded here
Lines+5added
Lines−3removed
From line
179
where the diff opens
First seen
14 Aug 2026
this site's first read of the page
Recorded edits45to this page, all time
The whole hunk
from line 179, old and new numbered
/
from line 179
179179
180180| Matcher | Fires when |
181181| :----------------------- | :------------------------------------------------------------------------------------------------------- |
182| `permission_prompt` | Claude needs you to approve a tool use and you haven't typed for about 6 seconds |
182| `permission_prompt` | Claude needs you to approve a tool use and the prompt has waited about six seconds |
183183| `idle_prompt` | Claude finished responding about 60 seconds ago and you haven't typed since |
184184| `auth_success` | Authentication completes |
185| `elicitation_dialog` | An MCP server opens an elicitation form and you haven't typed for about 6 seconds |
186| `elicitation_url_dialog` | An MCP server asks you to open a browser URL and you haven't typed for about 6 seconds |
185| `elicitation_dialog` | An MCP server opens an elicitation form and you haven't typed for about six seconds |
186| `elicitation_url_dialog` | An MCP server asks you to open a browser URL and you haven't typed for about six seconds |
187187| `elicitation_complete` | An MCP elicitation form is submitted or dismissed |
188188| `elicitation_response` | An MCP elicitation response is sent back to the server |
189189| `agent_needs_input` | A background session starts waiting on your input. Fires only while [agent view](/docs/en/agent-view) is open |
190190| `agent_completed` | A background session finishes or fails. Fires only while [agent view](/docs/en/agent-view) is open |
191
192Claude Code times `permission_prompt` differently in a terminal and in Claude Desktop, the VS Code extension, and other hosts that answer permission requests through the Agent SDK. See [when each notification type fires](/docs/en/hooks#notification) for both timings.
191193
192194The `agent_needs_input` and `agent_completed` matchers require Claude Code v2.1.198 or later.
193195
No line in this hunk matches that.