ghorgsync

Clone and update all organization repositories in one folder, with clean-state and branch audits plus warnings for stray content.

Why ghorgsync?

Working with many repositories across a GitHub organization or user account means constantly cloning new repos, pulling updates, and keeping track of local state. ghorgsync automates this into a single command that keeps your local directory in sync with your organization's or user's repositories—safely and non-destructively.

Key Features

• One command sync — clones missing repos, fetches and pulls existing ones, all in one pass
• Organization and user accounts — sync repos from a GitHub organization or a personal user account
• Non-destructive — never deletes directories, discards local changes, or runs destructive git commands
• Dirty repo detection — reports staged/unstaged changes with file details and line counts
• Branch drift audit — detects when a repo isn't on its default branch and corrects clean repos automatically
• Stray content warnings — identifies unknown folders and excluded-but-present repos in your directory
• Quiet by default — only prints actions taken and findings; --verbose adds API and git command diagnostics
• Colorized output — structured, color-coded terminal output (honors NO_COLOR)

Quick Start

1. Install

   go install github.com/UnitVectorY-Labs/ghorgsync@latest

2. Configure: create a .ghorgsync file in the directory where your repos live:

   For an organization:

   organization: my-org

   Or for a user account:

   user: my-username

3. Authenticate: set a GitHub token (or login with gh auth login):

   export GITHUB_TOKEN=ghp_...

4. Run

   cd ~/repos
   ghorgsync