[DOCS] subagentStatusLine documentation omits the new reasoning-effort payload field

Status Fixed / completed
Reported on v2.1.214
Maintainer reply None cached
Activity 1 comment · opened Jul 18, 2026 · closed Aug 17, 2026

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.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗