Follow Discord
Sweep 22 Oct 2026 · 21:04Z Build v2.1.309 528 read Stable v2.1.308 Latest v2.1.308 Next v2.1.309 Feeds RSS JSON llms.txt llms-full.txt Unofficial
Home / Reference / CLI flags

--on-branch

cli never mined JSON

A Claude Code CLI flag, read out of the shipped bundle. No mined inventory carries it: everything below comes from what this site has written about it.

Start a cloud session on your own environment with claude --environment, plus hidden --ref and --on-branch companions.

Not Anthropic's. This is the line from the earliest changelog entry here that named it, v2.1.224.

First seen — never in a mined build
Last seen — never in a mined build
Builds0 / 150on this box, as of v2.1.309
Written about v2.1.224 first named in a changelog, 7 Aug 2026

In the changelogs

7

Releases whose published page names --on-branch.

  1. v2.1.304
    Task launches can take their starting branch from --on-branch or --ref

    A launch path now uses the branch from --on-branch first, then the ref from --ref, and records which flag supplied it

    found in this entry's text

  2. v2.1.301
    Cloud session launch records which ref you chose and how

    Creating a cloud session now notes the ref you named and whether it came from --on-branch or --ref, plus a new file sync state

    found in this entry's text

  3. v2.1.290
    Clearer errors when creating a cloud session goes wrong

    If the server returns a session id Claude Code cannot use, it now warns a session may exist and points you to claude.ai/code

    found in this entry's text

  4. v2.1.277
    New git-branch-guard telemetry/env override for cloud session on-branch checkout

    Cloud on-branch checkout guard can now be forced on via a CCR_ON_BRANCH_DEFAULT_GUARD environment variable

    found in this entry's text

  5. v2.1.248
    Cloud and pool flags no longer confuse prompt detection

    Cloud flags like --pool and --ref no longer swallow their values as your prompt.

    named in this entry, found in this entry's text

  6. v2.1.232
    --project no longer starts a cloud session

    Passing --project alone won't start a cloud session; --ref and --on-branch now need --cloud or --environment.

    named in this entry, found in this entry's text

  7. v2.1.224
    Start a cloud session on a self-hosted environment with --environment

    Start a cloud session on your own environment with claude --environment, plus hidden --ref and --on-branch companions.

    named in this entry, found in this entry's text

First cited

2

The earliest release whose published evidence quoted --on-branch was v2.1.304, 19 Oct 2026. That is the oldest release this project wrote about it, so it is a floor on the name's age and not the release that introduced it. It is not a presence reading: which builds carried the name is the table below.

ReleaseDateThe span that was quoted
v2.1.30419 Oct 2026? { revision: e.poolOnBranch, flag: "--on-branch" }
v2.1.30419 Oct 2026{ revision: e.poolOnBranch, flag: "--on-branch" }

Presence across releases

0

The miner has never read a build containing this name. It is here because a changelog entry of ours names it, which is evidence that it existed and not evidence of which releases carried it. The inventory starts at v2.1.138 and everything older than that was never mined.

Read out of the published npm bundle release by release, and out of Anthropic's own documentation as this site captured it. Nothing on this page is a description anybody here wrote about what the CLI flag does. All CLI flags.

Feedback