[DOCS] CLI reference missing `--worktree` (`-w`) flag for isolated git worktrees
Documentation Type
Missing documentation (feature not documented)
Documentation Location
https://code.claude.com/docs/en/cli-reference
Section/Topic
CLI flags table for startup/session isolation flags.
Current Documentation
The CLI flags table lists many startup flags, for example:
--add-dir--agent--agents--continue--resume--session-id
There is currently no --worktree or -w flag entry.
What's Wrong or Missing?
Claude Code v2.1.49 added --worktree (-w) to start Claude in an isolated git worktree.
The CLI reference does not document this flag, so users cannot discover:
- the flag syntax,
- what isolation behavior it enables,
- default worktree location/branch behavior,
- interactions with other session flags.
Suggested Improvement
Add a --worktree, -w row to the CLI flags table with:
- purpose and high-level behavior,
- minimal example,
- notes on compatibility with
--resume,--continue, and normal repository workflows.
Impact
Medium - Makes feature difficult to understand
Additional Context
Affected Pages:
| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/cli-reference | 27-76 | CLI flags table has no --worktree/-w entry |
Total scope: 1 page affected
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗