[DOCS] Sessions docs omit `/cd` reappearing in old-directory resume list after non-graceful exit with special characters in path

Documentation Type

Missing documentation (feature not documented)

Documentation Location

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

Section/Topic

"Where the session picker looks" — the /cd relocation paragraph and the "Resume a session" entry-point table.

Current Documentation

The page describes /cd relocation at a high level:

"From v2.1.169, moving a session with /cd relocates it to the new directory's project storage, so it appears in that directory's picker afterward. Use Ctrl+W to widen to all worktrees of the repository or Ctrl+A to widen to every project on this machine."

"Selecting a session from another worktree of the same repository resumes it in place. Selecting a session from an unrelated project copies a cd and resume command to your clipboard instead."

"Resuming by name resolves across the current repository and its worktrees. Both forms look for an exact match and resume it directly even if it lives in a different worktree"

The page does not describe what happens when the session's old path contained characters the project-storage key normalization handles differently, or what happens after a non-graceful exit (kill -9, machine crash, force-quit).

What's Wrong or Missing?

Before v2.1.196, a session moved with /cd to a new directory could reappear in the old directory's session picker after a non-graceful exit when the old project path contained special characters (e.g. spaces, parentheses, non-ASCII characters). The cross-reference key produced by normalizing the old path differs from the new path's key in those cases, so the relocation did not always persist. v2.1.196 fixes the key normalization so the moved session stays in the new directory's picker. The docs do not document this case, so users hitting it before the fix could not tell whether /cd had worked at all, and post-fix users have no way to confirm the relocation is now reliable across paths with special characters.

Suggested Improvement

Extend the existing /cd paragraph under "Where the session picker looks" with a sentence covering the special-character / non-graceful-exit case:

"From v2.1.169, moving a session with /cd relocates it to the new directory's project storage, so it appears in that directory's picker afterward. As of v2.1.196, the relocation key normalizes paths with spaces, parentheses, and non-ASCII characters the same way on both sides, so a /cd move that ended with a non-graceful exit (kill -9, machine crash, force-quit) no longer leaves the session visible from the old directory's picker. Use Ctrl+W to widen to all worktrees of the repository or Ctrl+A to widen to every project on this machine."

Also link the related "Resume by name resolves across the current repository and its worktrees" note to the new paragraph so users recovering after an unexpected exit understand that name-based resume behaves the same regardless of where the session now lives.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:
| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/sessions | Primary location for /cd relocation and picker behavior |
| https://code.claude.com/docs/en/commands | Cross-reference for /cd command behavior |

Total scope: 2 pages affected.

v2.1.196 fixes /cd reappearing in the old directory's resume list when the path contains special characters and the move ended in a non-graceful exit. The session page only documents the general v2.1.169 relocation behavior; the v2.1.196 fix and the special-character / non-graceful-exit edge case are not mentioned.