Skip to content
BENIBIX Learn

SubagentHandback Tool

AI⌨️ Claude CodeBuilt-in Tools

Also known as SubagentHandback, Subagent report

How a helper hands back its report in auto mode.

Think of it like

It is like a teacher who checks your work first. Then it goes up on the wall.

Example

Emma runs a big change in auto mode. Each helper hands in its report with this tool, and the safety check reads every report on the way back.

Why it matters

In auto mode, no one clicks yes. So a helper's report gets checked before the main session uses it.

Definition

The SubagentHandback tool is how a subagent hands its final report back in auto mode. Before the report reaches the main session, the auto mode safety check reads it. Claude Code only gives this tool to local subagents in auto mode, not to forked ones. It needs version 2.1.271 or later. You never call it yourself.
In auto mode, a helper's report is checked on its way back.

Common mistake

Looking for it outside auto mode. It is only given to subagents when auto mode is on.

Key takeaways

  1. 1
    The report back. From a helper.
  2. 2
    Checked first. By the auto mode check.
  3. 3
    Auto mode only. Not in other modes.

Learn it properly