Repository navigation
Workspace Update Branch from Default
Open this from Repositories: divergence badge - yellow behind count on a feature branch.
When any feature branch falls behind the workspace default (main here), GrayMoon shows a yellow number in the behind | ahead pair. One click opens Update Branch, which fetches origin/<default> and merges it into your current branch. The flow is the same for every feature branch name and every workspace that clones the repo - not only the walkthrough below. No push - you stay in control of when the merge result leaves your machine.
Primary walkthrough: GrayMoon. Branch functionality-documentation was 1 commit behind main and 13 ahead. A second clone of the same repos in another workspace shows the same badge - see Same feature branch in another workspace.
On each repository row, the divergence cell shows behind | ahead relative to the default branch (not vs upstream - that is the green ↑N ↓N commits badge).
| Side | Meaning | Interaction on a feature branch |
|---|---|---|
| Behind (left) | Commits on origin/<default> that your branch does not have yet |
When > 0, yellow actionable button - click opens Update Branch |
| Ahead (right) | Commits on your branch that default does not have | Link to GitHub compare default...branch
|
On the default branch itself, behind is not actionable for this flow (incoming from origin/main is a pull, not merge-into-self). Tag-pinned repos hide the divergence cell entirely.
GrayMoon is on functionality-documentation. Divergence shows yellow 1 | 13: one commit landed on main that this feature branch does not include yet. Commits badge is still ↑0 ↓0 (local feature branch matches origin/functionality-documentation). Yellow create means no PR yet.

Tooltip on the yellow 1: This branch is 1 commit behind main.
Click the yellow behind number (not the ahead link, not Fetch).

| Element | Purpose |
|---|---|
| Title | Update Branch |
| Lead copy | Update functionality-documentation in GrayMoon with the latest changes from main (1 commit behind). |
| Step list | What GrayMoon will do (fetch, merge, success vs conflict) |
| Footer note | No automatic push - you stay in control. |
| 1 commit (outline) | Opens GitHub compare branch...default so you can inspect what you are about to merge in |
| Update Branch (primary) | Starts the job |
| Cancel | Closes without changing git state |
Enter confirms; Escape cancels.
Worker command: UpdateBranchFromDefault (UpdateBranchFromDefaultCommand).
-
Guard - if
.git/MERGE_HEADalready exists (a previous conflict left unresolved), GrayMoon refuses and tells you to finish that merge in your IDE first. -
Fetch -
git fetchfrom origin (default branch tip refreshed onorigin/<default>). -
Merge -
git merge --no-edit origin/<default>into the current feature branch. - Recount - refresh outgoing / incoming vs upstream and behind / ahead vs default so the grid updates without waiting for a hook.
This is a normal merge, not rebase. History on the feature branch keeps your commits; default's tip is merged in. Fast-forward happens when git can do it; otherwise git creates a merge commit.
GrayMoon does not:
- Push the result
- Open or update a PR
- Rewrite
.csproj/ run Restore - Abort an in-progress merge for you
Click Update Branch. Overlay: Updating branch in GrayMoon... with streamed git output. Toast: Branch updated successfully.
After this run:

| Column | Before | After |
|---|---|---|
| Behind | ahead | yellow 1 | 13
|
0 | 14 (no longer behind; ahead grew by the merge) |
Commits (↑N ↓N) |
↑0 ↓0 |
yellow ↑2 ↓0 - merge result is local only until you push |
| Branch | functionality-documentation |
unchanged |
| PR | yellow create | unchanged (still no PR) |
You now have the latest from main on your feature branch. Push when ready (header Push, or the commits badge) so origin and any open PR pick up the merge.
Update Branch is per clone, not per GitHub branch name. A second workspace that points at the same repositories can sit on the same feature branch and still show yellow behind until that working copy merges origin/<default>.
Complementary example: a second workspace cloning the same repos - also GrayMoon + GrayMoon.Desktop. GrayMoon is on functionality-documentation with yellow 1 | 13 (Desktop stays on main at 0 | 0). Same actionable behind badge; this clone simply has not run Update Branch yet.

Click the yellow 1. The dialog is the same flow - it names this workspace's current branch and repo:

Lead copy: Update functionality-documentation in GrayMoon with the latest changes from main (1 commit behind). Steps, No automatic push, and Update Branch / Cancel match the primary walkthrough above. Confirming runs the same Worker UpdateBranchFromDefault merge into the current feature branch on this clone only.
If git cannot merge cleanly, the Worker leaves the repo in a merge-in-progress state (MERGE_HEAD present) and returns the conflict file list.
GrayMoon shows an error toast, for example:
Merge conflict in N file(s): path1, path2. Resolve the conflicts in your IDE, then commit.
What that means for you:
- GrayMoon does not resolve conflicts - open the repo in Visual Studio, Rider, VS Code, or any git UI.
- Edit conflicted files, stage resolutions (
git add), then commit the merge (your IDE's "continue merge" / commit is fine). - Until you commit (or
git merge --abort), GrayMoon will refuse another Update Branch on that repo with: A merge is already in progress. Resolve the conflicts in your IDE first, then commit. - After you commit, use header Fetch or Sync (or wait for the Worker hook) so the grid refreshes behind / ahead and outgoing counts.
- Then push when you want origin updated.
Conflict detection uses git's merge exit status and porcelain status (UU, AA, DD, and related unmerged pairs).
| Goal | Use |
|---|---|
| Bring feature branch up to date with latest default | Yellow behind -> Update Branch (this page) |
| Discard feature work and return every clone to default | Return to Default |
| Pull teammate commits on the same branch | Red commits badge / header Pull - Incoming commits |
| Only refresh remote tips without merging | Header Fetch |
- Worker connected
- Repo on a branch (not a tag)
- Current branch is not the default branch
- Behind count > 0 (otherwise the badge is not the actionable yellow button)
- Repositories - Divergence - badge overview
- Return to Default - abandon feature branch and checkout default
- Switch Branch - checkout another existing branch without merging
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