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

Status Fixed / completed

Maintainer reply None cached

Activity 4 comments · opened Feb 18, 2026 · 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

Add workspace.added_dirs to 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_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 ↗

4 Comments

coygeek · 7 months ago

Still unresolved as of 2026-03-17. workspace.added_dirs does not appear in the statusline reference page or JSON schema example.

cesarvarela · 6 months ago

Found it thanks to this issue, but Claude told me it wasn't possible.

coygeek · 5 months ago

Issue #26709 Verification

Title: [DOCS] Status line documentation missing workspace.added_dirs field in JSON schema
Issue Date: 2026-02-18
Verification Date: 2026-04-27
Status: RESOLVED

Issue Summary

The issue reported that the status line documentation at code.claude.com/docs/en/statusline was missing the workspace.added_dirs field from both the "Available data" table and the full JSON schema example. This field was added in Claude Code v2.1.47 to expose directories added via /add-dir to external status line scripts.

Verification Results

Claim 1: `workspace.added_dirs` missing from the "Available data" field table

Status: RESOLVED
Evidence: The field table at statusline.md:156 now includes: workspace.added_dirs — "Additional directories added via /add-dir or --add-dir. Empty array if none have been added"
Verdict: The field is documented with its type, source, and default behavior.

Claim 2: `added_dirs` missing from the full JSON schema example

Status: RESOLVED
Evidence: The JSON schema at statusline.md:201 now includes "added_dirs": [] within the workspace object, alongside current_dir, project_dir, and git_worktree.
Verdict: The example schema accurately represents the field.

Claim 3: Changelog reference for the feature addition

Status: RESOLVED
Evidence: changelog.md:1590 contains: "Added added_dirs to the statusline JSON workspace section, exposing directories added via /add-dir to external scripts"
Verdict: The feature is tracked in the changelog.

Current State

| Location | Expected | Found |
|----------|----------|-------|
| Field table (statusline.md:156) | workspace.added_dirs row | Present with description |
| JSON schema (statusline.md:201) | "added_dirs": [] in workspace object | Present |
| Changelog (changelog.md:1590) | Release note entry | Present |

Suggested Fix

N/A — documentation has been updated.

References

Status line docs: https://code.claude.com/docs/en/statusline
Changelog entry: https://code.claude.com/docs/en/changelog (v2.1.47 section)
Source PR: anthropics/claude-code#26096

Conclusion & Recommendation

Primary Concern: The workspace.added_dirs field was undocumented in the status line reference.
Resolution Status: Fully resolved. All three requested documentation updates (field table, JSON schema example, and changelog) are now present in the docs mirror.
Recommendation: Close as completed.

github-actions[bot] · 3 months ago

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.