[DOCS] Status line documentation missing `workspace.added_dirs` field in JSON schema

Resolved 💬 4 comments Opened Feb 18, 2026 by coygeek Closed Apr 28, 2026

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

"Available data" table and "Full JSON schema" under the status line docs

Current Documentation

The status line field table documents:

  • workspace.current_dir
  • workspace.project_dir

The full JSON example also contains only:

"workspace": {
"current_dir": "/current/working/directory",
"project_dir": "/original/project/directory"
}

No workspace.added_dirs field is documented.

What's Wrong or Missing?

Claude Code v2.1.47 added added_dirs to status line JSON under workspace, exposing directories added via /add-dir. That field is absent from both the field table and the example schema.

As a result, status line scripts cannot reliably discover or display additional working directories even though runtime now exposes them.

Suggested Improvement

  1. Add workspace.added_dirs to the "Available data" table.
  2. Update the full JSON schema example to include it.
  3. Clarify type and behavior:
  • Type: array of absolute directory paths
  • Empty array when no extra directories are added

Suggested example snippet:

"workspace": {
"current_dir": "/current/working/directory",
"project_dir": "/original/project/directory",
"added_dirs": ["/repo/shared", "/repo/libs"]
}

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/statusline | 147-167 | Field table lists workspace fields but omits added_dirs |
| https://code.claude.com/docs/en/statusline | 181-184 | Full JSON schema omits added_dirs in workspace |
| https://code.claude.com/docs/en/permissions | 197-199 | /add-dir is documented, but statusline docs don't show how to observe added dirs |

Release note reference (v2.1.47):

  • "Added added_dirs to the statusline JSON workspace section, exposing directories added via /add-dir to external scripts"

Dedup check:

  • No open docs issue found for added_dirs + statusline.

View original on GitHub ↗

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