[DOCS] Task tool docs missing result metrics (token count, tool uses, duration)

Resolved 💬 3 comments Opened Feb 3, 2026 by coygeek Closed Feb 5, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/settings

Section/Topic

"Tools available to Claude" (Task / TaskOutput)

Current Documentation

The tools table currently only lists the tool names and short descriptions:

| TaskOutput | Retrieves output from a background task (bash shell or subagent) | No | | Task | Runs a sub-agent to handle complex, multi-step tasks | No |

No Task result fields are documented.

What's Wrong or Missing?

Changelog v2.1.30 adds new Task tool result metrics (token count, tool uses, duration). The docs do not mention these fields or how to interpret them, so users cannot leverage the new metrics in automation or debugging workflows.

Suggested Improvement

Add a short subsection under "Tools available to Claude" that lists the Task result fields and what they represent (token count, number of tool calls, and duration), with a small example snippet showing the fields in a Task result payload.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/settings | Tools available to Claude table |

Total scope: 1 page affected

Changelog reference: https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗