[DOCS] Task tool docs missing result metrics (token count, tool uses, duration)
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
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗