GitHub Organization Repository Synchronizer

github-org-sync is a cross-platform desktop and command-line application built with Python 3.11+, PySide6, and the GitHub CLI. It provides a visual and automated way to discover, clone, and update all repositories belonging to any GitHub organization.

New in Version 1.3.2

• Automatic Updates: Added automatic update checker on startup and manual check option in the Help menu. Downloads and installs updates directly from GitHub Releases without manual intervention.

New in Version 1.3.1

• Cross-Platform Release Packages: Packaged native executables and binaries for Linux (.tar.gz) and macOS (.zip) along with Windows (.zip).
• Cross-platform spec configurations for PyInstaller.

New in Version 1.3.0

• Open Existing Workspace Mode: Scan and inspect local Git repositories directly without specifying a GitHub organization name.
• Support for Non-GitHub Repositories: Safely scan and perform local Git operations (Fetch, Update, Open, etc.) on GitLab, Bitbucket, and other self-hosted/custom Git locations.
• Detected Organization Auto-fill: Automatically detects and populates the organization name if all scanned GitHub repositories belong to the same owner.
• Repository Grouping and Filtering: Filter repository views by hosting platforms and owners (e.g. GitHub / my-org, GitLab / project).
• Workspace-to-Org Verification: Instantly compare scanned local workspace repositories against any GitHub organization to highlight missing/extra repositories.

Windows Release Installation

To run the application on Windows without installing Python:

1. Download the release package (github-org-sync-v1.3.2-windows-x64.zip) from the Releases page.
2. Extract the complete archive to a directory of your choice.
3. Run github-org-sync.exe inside the extracted folder.

Important: The application still requires external command-line tools to interact with Git and GitHub. Make sure you have installed:

• Git (verify with git --version)
• GitHub CLI (gh) (verify with gh --version)

Before synchronizing private repositories, log in via the GitHub CLI:

gh auth login
gh auth status

Developer Guide & Requirements

• Python 3.11+
• Git installed and on PATH.
• GitHub CLI (gh) installed and authenticated.

Installation

1. Clone the repository:

   git clone https://github.com/MatthiasLew/github-org-sync.git
   cd github-org-sync

2. Create and activate a virtual environment:

   python -m venv .venv
   # On Windows:
   .venv\Scripts\activate
   # On Linux/macOS:
   source .venv/bin/activate

3. Install dependencies and the package:

   pip install -e .[dev]

Running the Application

GUI Mode

Run the desktop GUI via:

python -m github_org_sync

CLI Mode

Show status of repositories:

python -m github_org_sync.cli status --org subactor --workspace C:\Users\Praca\fork\subactor

Sync (clone and update) repositories:

python -m github_org_sync.cli sync --org subactor --workspace C:\Users\Praca\fork\subactor

Add --dry-run to run without performing any local modifications.

Running Tests

Run the test suite using:

python -m pytest -q

Packaging

To build a standalone executable on Windows:

.\scripts\build_windows.ps1

The output executable will be placed in the dist/ directory.