Skip to content
-- edited this page Nov 21, 2026 · 8 revisions

Welcome to the GrayMoon user guide. GrayMoon helps .NET teams work across many repositories as one coordinated workspace: clone related services and packages together, branch across all of them at once, roll out shared package updates safely, and push in dependency order so CI does not fail waiting on a package that is not published yet.

GrayMoon home page

Start here

If you want to... Go to
Understand what GrayMoon does What is GrayMoon?
Run the App in Docker (web only), or choose Docker vs Desktop Install the App
Go from a clean install to a cloned workspace Getting Started
Learn the shared UI (sidebar, search, overlays, notifications) Layout and Shared Chrome
Work inside a workspace (branches, updates, push, pull requests, Actions) Workspace Overview
Follow a complete real-world example Walkthrough: Tape Density or Walkthrough: Library Update

What a workspace looks like

A workspace groups related repositories, clones them side by side on disk, and sorts them into dependency levels so updates and pushes happen in the right order:

Workspace repositories grid

How GrayMoon fits together

GrayMoon is two parts. Keep both running for full functionality.

  1. GrayMoon App - the web UI and orchestration engine. Either the web-only Docker image on port 8384 (used from a browser), or the copy that GrayMoon Desktop starts alongside itself. Desktop never connects to a Docker App.
  2. GrayMoon Worker - a small service on your machine that does the actual git and filesystem work. The App itself never touches your disk.

You also need working connectors (GitHub, and NuGet if you publish packages). Each one must be Active with status OK before fetch, clone, push, package checks, or GitHub Actions will work.

A typical day

  1. Install the Worker (Administrator PowerShell; a Windows user password is required once).
  2. Add connectors, turn them Active, and confirm OK.
  3. Fetch repositories from GitHub into the catalog.
  4. Create a workspace and pick the repositories you need, or restore one from a repository that already contains graymoon.json, or import a folder that is already on this computer.
  5. Sync to clone them all under your workspace root path.
  6. Create or switch a feature branch across every selected repository.
  7. Run dependency or version updates when packages drift.
  8. Keep working in your IDE - GrayMoon keeps tracking commits, pushes, and merges through the Worker even when the browser is closed.

Browse by area

Outside a workspace (first-level sidebar): Home - Workspaces - Repository Catalog - Connectors - Worker - Settings

Inside a workspace: Repositories - Changes - Projects - Packages - Files - Dependencies - Actions

Common workflows: Features - New Branch - Switch Branch - Prepare Workspace - Return to Default - Restore Packages - Undo Push Commits - AI commit and pull request text

Use the sidebar on the right to jump straight to any page. Every page includes real screenshots from a running GrayMoon instance.

Clone this wiki locally