[DOCS] CLI reference missing `--worktree` (`-w`) flag for isolated git worktrees

Resolved 💬 3 comments Opened Feb 20, 2026 by coygeek Closed Feb 20, 2026

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

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗