{"name":"TeammateIdle","slug":"teammateidle","family":"hook","title":"Hook events","noun":"hook event","description":"When an [agent team](\/docs\/en\/agent-teams.md) teammate is about to go idle","description_source":"docs","described_by":{"doc":"claude-code\/hooks","title":"Hooks reference"},"presence":{"first_seen":null,"removed_in":null,"in_current_build":false,"newest_mined":"2.1.308","builds":0,"mined_builds":149,"first_cited":{"version":"2.1.64","released_at":"2026-03-03 03:19:58","spans":2}},"aliases":[],"entries":[{"version":"2.1.295","anchor":"hooks-can-now-fail-closed-via-an-on-failure-setting","heading":"Hooks can now block the action when they fail","line":"A new hook option set to `block` makes a hook that fails, times out or returns bad output stop the action it guards","released_at":"2026-10-08 18:22:58","reason":"found in this entry's text"},{"version":"2.1.248","anchor":"new-hook-events-and-compiled-in-plugin-admission-defaults","heading":"New hook events and compiled-in plugin admission defaults","line":"Three new hook event names appear, and unverified plugins are still allowed to load.","released_at":"2026-08-27 20:35:36","reason":"named in this entry, found in this entry's text"},{"version":"2.1.236","anchor":"some-hook-events-take-a-separate-dispatch-path","heading":"Some hook events take a separate dispatch path","line":"Six hook events now wait on a readiness step before running; the rest are unchanged.","released_at":"2026-08-19 18:45:14","reason":"found in this entry's text"},{"version":"2.1.223","anchor":"hook-feedback-meta-messages-identified-by-hook-name-instead-","heading":"Hook-feedback meta messages identified by hook name instead of a line suffix","line":"Your own messages won't be mistaken for hook feedback just because they end with a marker.","released_at":"2026-08-05 22:51:13","reason":"found in this entry's text"},{"version":"2.1.223","anchor":"only-four-hook-types-produce-non-user-content","heading":"Only four hook types produce non-user content","line":"Only Stop, TeammateIdle, TaskCreated and TaskCompleted hooks are treated as internal; other hook feedback reads as your text.","released_at":"2026-08-05 22:51:13","reason":"named in this entry, found in this entry's text"},{"version":"2.1.178","anchor":"named-teammate-agent-swarms-teamcreate-teamdelete-removed","heading":"Named-Teammate Agent Swarms (TeamCreate\/TeamDelete Removed)","line":null,"released_at":"2026-06-15 19:03:37","reason":"found in this entry's text"},{"version":"2.1.178","anchor":"notes","heading":"","line":null,"released_at":"2026-06-15 19:03:37","reason":"found in this entry's text"},{"version":"2.1.69","anchor":"new-hook-events","heading":"New Hook Events","line":null,"released_at":"2026-03-04 21:46:46","reason":"found in this entry's text"},{"version":"2.1.64","anchor":"taskcompleted-and-teammateidle-hooks-can-block-continuation","heading":"TaskCompleted and TeammateIdle Hooks Can Block Continuation","line":null,"released_at":"2026-03-03 03:19:58","reason":"found in this entry's text"},{"version":"2.1.33","anchor":"teammateidle-and-taskcompleted-hooks","heading":"TeammateIdle and TaskCompleted Hooks","line":null,"released_at":"2026-02-06 00:16:13","reason":"found in this entry's text"}],"entries_total":10,"docs":[{"source":"claude-code","path":"hooks","title":"Hooks reference","documented":true},{"source":"claude-code","path":"agent-sdk\/hooks","title":"Intercept and control agent behavior with hooks","documented":true},{"source":"claude-code","path":"agent-sdk\/claude-code-features","title":"Use Claude Code features in the SDK","documented":false},{"source":"claude-code","path":"agent-sdk\/typescript","title":"Agent SDK reference - TypeScript","documented":false},{"source":"claude-code","path":"agent-teams","title":"Orchestrate teams of Claude Code sessions","documented":false},{"source":"claude-code","path":"changelog","title":"Claude Code changelog","documented":false},{"source":"claude-code","path":"hooks-guide","title":"Automate actions with hooks","documented":false}],"docs_total":7,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/hook\/teammateidle","family_url":"https:\/\/changelogs.core-directive.com\/reference\/hook.json"}