Skip to content

Workspace New Branch

-- edited this page Nov 21, 2026 · 6 revisions

Same dialog as Switch Branch. Two tabs. Workspace-wide: every repository in the workspace gets the new branch. Prepare Workspace is a different wizard: branch plus update plus synchronized push. Full write-up: Prepare Workspace. Jumping to a branch that already exists is Switch Branch.

On MezzoRecovery (a real multi-repo project, 11 repos) the header Branch caret opens:

Branch menu

  • Prepare Workspace - Prepare Workspace.
  • New Branch - this dialog, New Branch tab (same as clicking the primary Branch button).
  • Switch Branch - this dialog, Switch Branch tab. Full write-up: Switch Branch.
  • Create PR / Return to Default - not this dialog. Return to Default is Return to Default.

The dialog

Title: {WorkspaceName} Branch (here MezzoRecovery Branch). Tabs: New Branch | Switch Branch. Escape or the X / Cancel closes it.

New Branch tab

New Branch tab

  • Branch name - required. Placeholder e.g. feature/my-feature. Focused when the dialog opens. Create stays disabled until the name is non-empty. Enter submits like Create.
  • Based on - which commit the new branch starts from. Default is each repo's default branch, shown as that name (main) with a green Default badge (or multiple if defaults differ). The list also has every branch name that exists in all repos.
  • Skip repos on tags - footer checkbox, only when at least one repo is on a tag. Not shown here (nothing is tagged). Checked: tagged repos are left alone.
  • Create / Cancel.

If the name already exists in one or more repos, a warning asks to Proceed (check out the existing branch there) or Cancel.

Where the branch already existed, nothing is created: the existing branch is checked out as it is, so it is not based on what you chose in Based on and may be older. After the job an amber warning names those repositories, for example "Branch 'new-branch-demo' already existed in 2 repositories (api, web). It was checked out as it is and was not created from the base branch." The same warning appears for New Branch on one repository and for Prepare Workspace. A branch that cannot be created for another reason (a base that does not exist, local changes in the way) is shown as an error on that repository, which stays on the branch it was on.

Filled for this run (new-branch-demo, based on default main):

New Branch filled

Switch Branch tab

Same shell, different body. Check out a branch that already exists across the workspace. Conditions, badges, and a jump from new-feature-demo to new-branch-demo are in Switch Branch.

Create

Create closes the dialog and runs a workspace job: overlay Creating branches... then Created N of M, Abort, live git log. Each repo gets git checkout -b from the chosen base (default branch, or the named common branch).

On MezzoRecovery that created new-branch-demo on all 11 repos from main:

After New Branch

What changed on the grid:

  • Branch column is new-branch-demo on every row.
  • GitVersion Version strings pick up the branch (0.1.0-new-branch-demo.39 instead of 0.1.0-main.39).
  • Commits badge is a yellow cloud-up on repos with no upstream yet (the new branch has not been pushed). in sync stays blue: local status matches what the Worker last reported.
  • Higher levels show unmatched-deps badges (2 of 2, 4 of 4, ...) because package versions now include the new branch name. Header Push Updated (yellow) is the update-then-push shortcut for that. That is expected after leaving main; it is not a failed create. Hover a red N of M badge for current -> new package lines. Running Update Only then Push Only from that menu (the two halves of Push Updated) is in Repositories.

Clicking a row Branch cell opens the per-repo branch dialog (Locals / Remotes / Tags / New Branch), not this workspace-wide tab. Workspace Switch Branch is the header Branch caret.

Clone this wiki locally