Skip to content

Workspace Overview

Matt Janda edited this page Nov 6, 2026 · 4 revisions

Opening a workspace from Workspaces replaces the first-level sidebar with workspace navigation. The top bar shows the workspace name - click it to return to the Workspaces list.

Examples in these pages use GrayMoon (a small two-repo workspace) and MezzoRecovery (eleven repos: services, libraries, and tools that share packages).

Pages

Page What it is for
Repositories Main grid: branches, versions, deps, push, PRs
Changes Multi-repo staged/unstaged changes and commit
Projects .csproj inventory for the workspace
Packages Package references and registry view
Files Pinned files and version-token configs (for example .env)
Dependencies Dependency graph across workspace repos
Actions GitHub Actions for the current branch

Common workflows

Workflow Doc
Restore NuGet packages (fresh, no cache) Restore packages
Create a branch across repos New Branch
Switch branch or pin a tag Switch Branch
Bring a feature branch up to date with default Update branch from default
Pull incoming commits Incoming commits
Declare extra ordering edges Custom dependencies
Worktree checkout beside the workspace Features
Branch + optional update + push in one wizard Prepare Workspace
After merge: return everyone to default Return to Default
Reset local outgoing commits before push Undo Push Commits
Leave a tag pin and return to main Checkout from tags
Notice a newer tag and upgrade the pin Tag upgrade
Manage branches per repository Repository branch management
What happens when push fails on a protected default branch Protected branch and push failure

End-to-end walkthroughs

Walkthrough Focus
Library-update Dependency-only rollout with some repos frozen on tags
Tape-density Full feature lifecycle: prepare, implement, push, PRs, merge

What a Basic workspace hides

Projects, Packages, Dependencies, the Version column, level groups, dependency badges, Update, Push Updated, and Restore are hidden on a Basic workspace. Actions is hidden when GitHub Actions is off. Opening one of those pages directly says Projects are only available for .NET Dependency workspaces. or CI is not enabled for this workspace. and offers Back to Repositories.

Merge PRs... is on the header Branch menu, because a Basic workspace has no level menus. Update Files appears only while a version file is out of date.

Clone this wiki locally