Repository navigation
Workspace New Branch
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:

- 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.
Title: {WorkspaceName} Branch (here MezzoRecovery Branch). Tabs: New Branch | Switch Branch. Escape or the X / Cancel closes it.

-
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 (ormultipleif 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):

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 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:

What changed on the grid:
-
Branch column is
new-branch-demoon every row. - GitVersion Version strings pick up the branch (
0.1.0-new-branch-demo.39instead of0.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 leavingmain; it is not a failed create. Hover a redN of Mbadge forcurrent -> newpackage 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.
Overview
Using the App
- Layout
- Shared Chrome
- Home page
- Workspaces
- Restore from repository
- Import from disk
- Repository Catalog
- Connectors
- Worker
- Settings
Workspace pages
- Overview
- Repositories
- Changes
- AI commit and pull request text
- Projects
- Packages
- Files
- Dependencies
- Actions
Workspace workflows
- New Branch
- Switch Branch
- Features (worktrees)
- Prepare Workspace
- Return to Default
- Restore Packages
- Update Branch from Default
- Incoming Commits
- Undo Push Commits
- Custom Dependencies
- Checkout from Tags
- Tag Upgrade
- Repository Branch Management
- Protected Branch and Push Failure
Walkthroughs