[DOCS] `/cd` command missing from the built-in commands reference table

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

The "All commands" reference table on the Commands page (the main table that lists every built-in slash command and bundled skill/Workflow). The /cd entry announced in v2.1.169 is not present anywhere in that table.

Current Documentation

The "All commands" table on https://code.claude.com/docs/en/commands currently has no row for /cd. The closest existing row, for /add-dir, reads:

| /add-dir <path> | Add a working directory for file access during the current session. Most .claude/ configuration is not discovered from the added directory. You can later resume the session from the added directory with --continue or --resume |

The changelog at https://code.claude.com/docs/en/changelog (v2.1.169, "June 8, 2026") announces the feature but does not link to a docs page:

* Added /cd command to move a session to a new working directory without breaking the prompt cache mid-session

The prompt-caching page at https://code.claude.com/docs/en/prompt-caching#cache-scope documents that the cache is "scoped to one machine and directory" because the system prompt embeds the working directory, but does not mention /cd as a way to change directories without invalidating that cache.

What's Wrong or Missing?

A. /cd is absent from the commands reference table

/cd is announced in the v2.1.169 changelog as a new built-in command but is not listed in the "All commands" table on https://code.claude.com/docs/en/commands. Users searching that page for a way to switch the session's working directory will not find it.

B. The cache-preservation behavior is undocumented

The changelog frames /cd specifically as "move a session to a new working directory without breaking the prompt cache mid-session," but neither the commands page nor the prompt-caching page mentions this. The prompt-caching page explicitly states that cache scope is directory-bound, with no pointer to /cd as a cache-friendly way to switch directories.

C. No cross-reference from prompt-caching or related pages

The prompt-caching, tools-reference, and sub-agents pages all discuss working-directory changes mid-session (and the fact that they do not persist into subagents, and that cd in the main session carries over to later Bash commands). None of them mention /cd, so users reading those pages will not learn that a cache-preserving session-level directory change command exists.

Suggested Improvement

Option A: Add a row to the "All commands" table

Add a row to the table on https://code.claude.com/docs/en/commands, alphabetically placed between /btw and /chrome (or after /config to keep cd grouped near other session-level directory controls):

| `/cd <path>` | Change the session's working directory. Unlike running `cd` through the Bash tool, the session's prompt cache survives the switch, so subsequent requests stay on the same cached prefix. Path is relative to the current working directory unless absolute. |

Option B: Cross-reference from the prompt-caching page

On https://code.claude.com/docs/en/prompt-caching#cache-scope, after the paragraph that says the cache is "scoped to one machine and directory," add a sentence such as:

To change the session's working directory without invalidating the cache, use /cd (added in v2.1.169). Running cd through the Bash tool still updates the directory but the prompt-cache prefix will not carry across the change.

Minimum fix

At minimum, add the table row from Option A so the command is discoverable from the commands reference.

Impact

High - Prevents users from using a feature

Additional Context

The /cd entry appears only in the changelog:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/changelog | 15 | "Added /cd command to move a session to a new working directory without breaking the prompt cache mid-session" under the 2.1.169 update (June 8, 2026) |

Related pages that discuss working-directory changes or the cache, and which do not mention /cd:

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 46-48+ | "All commands" reference table is missing the /cd row |
| https://code.claude.com/docs/en/prompt-caching | 200-202 | "Cache scope" section explains the directory-bound cache without pointing to /cd as a cache-preserving way to change directories |
| https://code.claude.com/docs/en/tools-reference | 111 | Documents cd in the Bash tool carrying the working directory over to later Bash commands; no mention of /cd |
| https://code.claude.com/docs/en/sub-agents | 259 | Notes that subagent cd calls do not persist; no mention of /cd for the main session |

Total scope: 4 pages affected (one missing entry, three that should cross-reference it).

Changelog version: v2.1.169 (June 8, 2026).