Skip to content

Workspace Checkout from Tags

Matt Janda edited this page Oct 15, 2026 · 4 revisions

Open this from Repositories.

After workflows like library-update or tag upgrade, some Level 1 repos may stay frozen on release tags while the rest of the workspace is on main. GrayMoon suppresses divergence, PR, and commit badges on those rows until you check out a branch again.

This page shows two ways to move tag-pinned repos back to the default branch (main):

  1. Per-repo - click one tag, open the branch dialog, check out main for that clone only.
  2. Workspace-wide - header Branch caret, Switch Branch, select main, and uncheck Skip repos on tags so tagged repos are included in the checkout.

Both paths only run git checkout - they do not delete branches, rewrite .csproj files, or push. For abandoning a feature branch entirely, use Return to Default instead.

Walkthrough workspace: MezzoRecovery, a real multi-repo project. Starting state after Phase 5: four Level 1 repos on tags (TapeDrive / TapeImage 0.2.0, Website / DockerBase 1.0.0); all other repos already on main.

Starting state

Four Level 1 repos on tags, rest on main

Repo Branch column Frozen?
MezzoRecovery.TapeDrive tag 0.2.0 yes
MezzoRecovery.TapeImage tag 0.2.0 yes
MezzoRecovery.Website tag 1.0.0 yes
MezzoRecovery.DockerBase tag 1.0.0 yes
All other repos main no

Tooltip on a tag cell: Repository is pinned to a tag. Click to switch.

See frozen grid behavior for what disappears while a repo is on a tag.

Method 1 - One repo at a time (per-repo branch dialog)

Use this when you only need to unfreeze one or two repos, or when tagged repos should move to main at different times.

Step 1 - Click the tag in the Branch column

On MezzoRecovery.TapeDrive, click the Branch cell (tag icon + 0.2.0).

GrayMoon opens Branch - MezzoRecovery.TapeDrive on the Tags tab with Current on the active tag (same dialog shell as repository branch management; Tags tab example from TapeImage):

Per-repo dialog on Tags tab

Step 2 - Switch to Locals and select main

Open the Locals tab. Select main (the repo default). Check out enables because the clone is still pinned to the tag, not on main.

Locals tab with main selected

Click Check out. A brief Worker job runs (Checking out...). The dialog closes.

Step 3 - Repeat for other tag repos (if needed)

TapeDrive now shows main in the Branch column with full divergence / PR / commit badges restored. The other three tag repos are unchanged until you repeat the same steps on each row.

TapeDrive on main; other tag repos unchanged

Per-repo checkout details (all four tabs, Fetch, delete branch): Repository branch management.

Method 2 - All repos at once (workspace Switch Branch)

Use this when every tag-pinned repo should land on main in one job.

Step 1 - Open Switch Branch

Header Branch caret -> Switch Branch. Same dialog as Switch Branch (MezzoRecovery Branch, Switch Branch tab).

Branch menu

Step 2 - Select main

Pick main (green Default badge). The list shows only branch names that exist in every repository in the workspace.

Step 3 - Skip repos on tags (default)

When at least one repo is on a tag, the footer shows Skip repos on tags. It defaults to checked:

main selected, Skip repos on tags checked

With the box checked, tagged repos are excluded from the checkout. Check out moves only repos already on a branch (here, the eight repos already on main - a no-op). TapeDrive, TapeImage, Website, and DockerBase stay on their tags.

That default matches Prepare Workspace and New Branch: release-pinned repos are left alone unless you opt in.

Step 4 - Uncheck Skip repos on tags

Clear Skip repos on tags to include tag-pinned repos in the workspace checkout:

main selected, Skip repos on tags unchecked

Tooltip on the checkbox: Repositories checked out on a tag will not be affected (when checked). Unchecking removes that filter - all 11 repos are eligible for git checkout main.

Click Check out. Overlay Checking out... then Checked out N of M. Every repo, including the four that were on tags, moves to main.

After workspace checkout

All 11 repos on main

Column State
Branch main on every row - no tag icons
Version *-main.* GitVersion on branch repos
Divergence / PR / Commits visible again on rows that were frozen
Deps GrayMoon recomputes package badges against live GitVersion

Run header Sync -> Fetch or a full Sync if you want remote tips and dependency math refreshed immediately after the checkout.

Which method to use

Situation Prefer
Unfreeze one repo for a quick fix Per-repo dialog (Method 1)
Move every tag-pinned repo to main after a feature lands Workspace Switch Branch with Skip repos on tags off (Method 2)
Prepare a workspace branch but keep some repos on release tags Workspace Prepare Workspace / Switch Branch with Skip repos on tags on (default)
Drop a feature branch and delete it Return to Default - not Switch Branch

Related docs

Clone this wiki locally