org-mirror

org-mirror

Mirror every repository accessible to your GitHub CLI account in an organization as normal local Git working copies. The tool calls the GitHub API with the same credentials stored by GitHub CLI and uses git to clone and update working copies safely. It never executes gh as a subprocess.

Installation

go install github.com/inovacc/org-mirror/cmd/org-mirror@latest

Before running it, install Git and GitHub CLI, then log in:

gh auth login

Usage

# List actions without cloning or updating anything.
org-mirror sync floci-io --dry-run

# Disable the automatic interactive progress interface.
org-mirror sync floci-io --no-tui

# Mirror into C:\Users\dyamm\Downloads\mirror\orgs\floci-io\<repository>.
org-mirror sync floci-io

# Choose another parent directory.
org-mirror sync floci-io --root D:\\mirrors

# Choose another sync-history database.
org-mirror sync floci-io --database D:\\mirrors\\database.db

Each real run writes C:\Users\dyamm\Downloads\mirror\orgs\<organization>\metadata.json by default. It includes the UTC run time and, for each discovered repository, its local path, GitHub properties, default branch, sync outcome, and local/upstream commit hashes when available.

Every run also appends history to C:\Users\dyamm\Downloads\mirror\database.db. The SQLite database contains sync_runs (organization, start/end time, status, and repository count) and repositories (branch, local/upstream commit SHA, open issue count, outcome, path, timestamp, and message). Use --database to change its path.

The mirror never resets, stashes, deletes, or overwrites a working copy. A dirty, ahead, diverged, or detached checkout is left unchanged and recorded as a conflict. Failures in one repository are recorded while the remaining repositories continue. Interactive terminals show the current repository, completed work, and remaining queue in a full-screen interface. Redirected output and --no-tui use plain text instead.

Commands

Development

# Build
task build

# Run
task run

# Test
task test

# Lint
task lint

License

BSD-3