[DOCS] subagentStatusLine documentation omits the new reasoning-effort payload field
Documentation Type
Unclear/confusing documentation
Documentation Location
https://code.claude.com/docs/en/statusline
Section/Topic
“Subagent status lines,” especially the per-task input-field list.
Current Documentation
The status-line reference currently says:
The command runs once per refresh tick with all visible subagent rows passed as a single JSON object on stdin.
It lists each task’s fields as id, name, type, status, description, label, startTime, model, contextWindowSize, tokenCount, tokenSamples, and cwd. The same page documents effort.level for the main status-line payload, but the subagent task-field list does not include the new reasoning-effort field.
What's Wrong or Missing?
Claude Code 2.1.214 adds reasoning effort to the subagentStatusLine payload so custom agent rows can render the model and effort. The existing subagentStatusLine reference documents the payload shape and enumerates the per-task fields, but that list does not contain the new field, its possible values, or its absent-field behavior.
Plugin authors cannot reliably update an existing subagentStatusLine renderer to show the new effort value, and they cannot tell whether the field is absent for unsupported models or older Claude Code versions.
Suggested Improvement
Update the existing “Subagent status lines” subsection with:
- the exact reasoning-effort field name alongside the existing model field;
- the allowed effort values and absent-field behavior;
- a version marker for the 2.1.214 addition; and
- a minimal plugin settings.json and renderer example that displays both model and effort.
Cross-link this subsection from the general status-line reference and explain whether the payload is delivered through stdin in the same way.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/statusline | subagentStatusLine per-task input fields and the main status-line effort field |
| https://code.claude.com/docs/en/plugins-reference | Plugin settings.json cross-reference for subagentStatusLine support |
Release: Claude Code 2.1.214.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗