[DOCS] Status line documentation missing `workspace.added_dirs` field in JSON schema
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_dirworkspace.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
- Add
workspace.added_dirsto the "Available data" table. - Update the full JSON schema example to include it.
- 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_dirsto the statusline JSONworkspacesection, exposing directories added via/add-dirto external scripts"
Dedup check:
- No open docs issue found for
added_dirs+statusline.
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗