Repository navigation
Workspace Checkout from Tags
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):
-
Per-repo - click one tag, open the branch dialog, check out
mainfor that clone only. -
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.

| 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.
Use this when you only need to unfreeze one or two repos, or when tagged repos should move to main at different times.
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):

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

Click Check out. A brief Worker job runs (Checking out...). The dialog closes.
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.

Per-repo checkout details (all four tabs, Fetch, delete branch): Repository branch management.
Use this when every tag-pinned repo should land on main in one job.
Header Branch caret -> Switch Branch. Same dialog as Switch Branch (MezzoRecovery Branch, Switch Branch tab).

Pick main (green Default badge). The list shows only branch names that exist in every repository in the workspace.
When at least one repo is on a tag, the footer shows Skip repos on tags. It defaults to 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.
Clear Skip repos on tags to include tag-pinned repos in the workspace checkout:

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.

| 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.
| 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 |
- Switch Branch - workspace-wide checkout, common branch list, Fetch
- Repository branch management - per-repo Locals / Remotes / Tags / New Branch
- Tag upgrade - moving to a newer tag (opposite direction)
- Prepare Workspace - Skip repos on tags - why tagged repos are skipped by default
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