Repository navigation
What is GrayMoon
GrayMoon is a .NET multi-repository orchestration tool for teams that build with microservices and shared packages.
If a shared library changes and dozens of repositories need updates, GrayMoon can drive that rollout from one place instead of editing each repo by hand.
A Basic workspace is git only: branches, Changes, and pull requests, without package levels. A .NET Dependency workspace is the package rollout described below. A Feature is a worktree set of the current Workspace branch. Desktop runs this App in its own window. A Docker App is a separate install and does not attach to Desktop.
- .NET teams with multiple services and shared libraries or packages
- teams that use semantic versioning with GitVersion
- developers doing cross-repository feature work
- teams using AI IDEs (VS Code / Cursor) or AI coding agents (Claude, Codex, Cursor Agent) where cross-repo context helps productivity
- Clone and organize multiple repositories under one workspace
- Create or switch feature branches across repositories together
- Keep repository status up to date while you work in your IDE (checkout, commit, push, and merge events are tracked)
- Track versions and dependency drift
- Update
PackageReferenceversions automatically - Run
dotnet restore --force --no-cacheso NuGet does not fall back to stale cached packages after dependency changes - Sync back to the default branch after merge (one repo or many, by dependency level)
- Push in dependency order so CI is less likely to fail because a package version is not published yet
- Group repositories by dependency level and type (services vs packages/libraries)
- See GitHub Actions results for the current branch across the whole workspace
- Create pull requests for one, several, or all eligible workspace repositories from one dialog (optional reviewers and draft)
- Write the commit message and the pull request title and description with the Claude, Codex, or Cursor Agent CLI already installed on the host
- Build a CodeGraph index for a new Feature so an AI coding agent has accurate cross-repository context from the start
- One view of branch, version, PR, and Actions status across repositories
- Coordinated dependency updates instead of manual edits in every repo
- After package refs change, a forced fresh NuGet restore so local builds match what you just rolled out
- One feature branch across repos with optional auto-update, commit, and push
- Parallel pushes within a level so the full workflow finishes faster than pushing repo-by-repo
- Tracking of changed files across repositories so you can avoid unnecessary PRs when only dependency versions changed
- AI-drafted commit messages and pull request text, built from the actual git evidence instead of a blank box
The App (the Docker web app, or the copy GrayMoon Desktop runs alongside itself) owns the web UI, database, and orchestration. The Worker (host service) owns git and the filesystem. Connectors store GitHub and NuGet credentials. Workspace repositories are sorted into dependency levels so update and push happen in a safe order: level 1 has no workspace dependencies; higher levels depend on lower ones.
- Install the App
- Getting started - Worker, connectors, fetch, first workspace
- Workspace - day-to-day multi-repo work
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