--- title: "Git-Same" url: https://zaai.com/git-same/ description: "Mirror GitHub org and repo structures locally. One Homebrew install, interactive TUI, parallel cloning." --- ![Git-Same icon](https://zaai.com/git-same/icon.svg) Rust CLI · macOS / Linux # Every GitHub repo you own, synced to your filesystem. Mirror GitHub org and repo structures locally. One Homebrew install, interactive TUI, parallel cloning. [View on GitHub](https://github.com/ZAAI-com/git-same) [Read the docs](https://github.com/ZAAI-com/git-same/blob/main/docs/README.md) brew install --cask zaai-com/tap/git-same ![Git-Same TUI dashboard showing workspace status and sync actions](https://zaai.com/git-same/screenshots/tui-dashboard-dark.png) What it mirrors ## The folder structure on GitHub _is_ the folder structure on disk. GitHub URLs on the left, your filesystem tree on the right. Same names, same nesting, no surprises. git-same · mirror plan In sync · 1 user · 2 orgs · 7 repos URL hierarchy github.com git-same sync Filesystem hierarchy ~/same-github/ URL hierarchy - github.com - github.com/manuelgruber - github.com/manuelgruber/.github - github.com/manuelgruber/dotfiles - github.com/zaai-com - github.com/zaai-com/clean-autofill - github.com/zaai-com/git-same - github.com/zaai-com/jekyll-aeo - github.com/zaai-com/powernight - github.com/company1 - github.com/company1/example.ai Filesystem hierarchy - ~/same-github/ - ├── manuelgruber/ - │   ├── .github/ - │   └── dotfiles/ - ├── zaai-com/ - │   ├── clean-autofill/ - │   ├── git-same/ - │   ├── jekyll-aeo/ - │   └── powernight/ - └── company1/ -     └── example.ai/ 1 user · 2 orgs · 7 repos · 100% mirrored Sneak Peek Preview ## Finder Badges. Workspaces, visible in Finder. Coming soon Git-Same is bringing workspace status to macOS Finder. Folders managed by Git-Same get a small badge so you can spot synced repos at a glance, without leaving Finder. [Follow releases on GitHub](https://github.com/ZAAI-com/git-same/releases) ![macOS Finder window showing folders with small green Git-Same badges next to repository folders](https://zaai.com/git-same/screenshots/finder-badges.png) Workflow ## Interactive when you want it. Scriptable when you need it. Run `git-same` for the full TUI, or use subcommands directly in repeatable shell workflows. 01 `git-same init` ### Create config Run init to create a config file at ~/.config/git-same/config.toml with sensible defaults. 02 `git-same setup` ### Set up a workspace Choose GitHub.com or GitHub Enterprise, authenticate through GitHub CLI, select organizations, and choose the local root folder. 03 `git-same sync` ### Sync in parallel Clone missing repositories and fetch or pull existing ones concurrently, while skipping local repos with uncommitted work by default. 04 `git-same status` ### Check status anytime See which repositories are dirty, behind upstream, or ready before you switch projects or shut down for the day. Installation ## Three ways to install. On macOS, the signed and notarized Homebrew cask is the recommended path. On Linux and headless macOS, install the `git-same-cli` formula. Both install all aliases automatically. Cargo works on any platform with the Rust toolchain. [GitHub Releases Pre-built binaries for macOS and Linux (x86\_64 + ARM64) and Windows.](https://github.com/ZAAI-com/git-same/releases) [crates.io Install with Cargo when you prefer Rust tooling.](https://crates.io/crates/git-same) ```bash brew install --cask zaai-com/tap/git-same ``` Screenshots ## The whole workspace, visible in the terminal. ![Git-Same terminal dashboard in dark mode](https://zaai.com/git-same/screenshots/tui-dashboard-dark.png) _TUI dashboard Workspace stats, quick actions, recent sync activity, and repo health in one terminal view._ ![Git-Same terminal dashboard in light mode](https://zaai.com/git-same/screenshots/tui-dashboard-light.png) _Light mode The same dashboard adapts cleanly for light terminal themes._ ![Git-Same setup wizard selecting GitHub organizations](https://zaai.com/git-same/screenshots/tui-setup-workspace.png) _Workspace setup Pick providers, organizations, filters, and the local base path interactively._ ![Git-Same discovering repositories before sync](https://zaai.com/git-same/screenshots/tui-sync-discovery.png) _Discovery Build the sync plan from GitHub before cloning or fetching anything._ ![Git-Same sync progress while cloning and fetching repositories](https://zaai.com/git-same/screenshots/tui-sync-running.png) _Live sync Parallel clone and fetch progress with active workers and per-repo status._ ![Git-Same completed sync summary](https://zaai.com/git-same/screenshots/tui-sync-completed.png) _Completed run Review updated, cloned, skipped, and failed repos after the sync finishes._ ![Git-Same CLI status output listing repository state](https://zaai.com/git-same/screenshots/cli-status.png) _CLI status Script-friendly status checks for dirty repos, behind branches, and workspace health._ Commands ## Every subcommand, in one place. | Command | Description | | --- | --- | | `git-same` | Launch the interactive TUI (no subcommand) | | `git-same init` | Create config file with sensible defaults | | `git-same setup` | Interactive wizard to configure a workspace | | `git-same sync` | Discover, clone new, and fetch/pull existing repos | | `git-same status` | Show git status across all local repos | | `git-same workspace` | List workspaces, set or clear default | | `git-same scan` | Discover repos without cloning or syncing | | `git-same reset` | Remove all config, workspaces, and cache | TUI ## Every screen, every shortcut. Run `git-same` without a subcommand to open the full-screen terminal UI. Navigate with keyboard shortcuts across all screens. | Screen | Purpose | Key bindings | | --- | --- | --- | | Dashboard | Overview with stats and quick actions | s: Sync · t: Status · w: Workspaces · ?: Settings | | Workspace Selector | Pick active workspace | Enter: Select · d: Set default · n: New | | Init Check | System requirements check | Enter: Check · c: Create config · s: Setup | | Setup Wizard | Interactive workspace configuration | Step-by-step prompts | | Command Picker | Choose operation to run | Enter: Run | | Progress | Live sync progress with per-repo updates | Esc: Back when complete | | Repo Status | Table of local repos with git status | /: Filter · D: Uncommitted · B: Behind · r: Refresh | | Org Browser | Browse discovered repos by organization | ← ↑ ↓ → Navigate | | Settings | View workspace settings | Esc: Back | Aliases ## Use the name that fits your muscle memory. The Homebrew cask (macOS) and the `git-same-cli` formula (Linux) both install the primary binary plus short aliases automatically. All aliases work identically. `git-same` `gitsame` `gitsa` `gisa` `git same` Note: `cargo install git-same` installs only the primary binary. Both Homebrew install paths include all aliases. ```bash # All of these run the same sync git-same sync gitsame sync gitsa sync gisa sync git same sync ``` Requirements ## Uses the tools already in a GitHub developer setup. **git** Git-Same shells out to Git for clone, fetch, pull, and status operations. Must be in your PATH. **GitHub CLI (`gh`)** Authentication uses `gh auth login`, so there is no separate token flow to manage. Git-Same calls `gh auth token` to obtain API credentials. ```bash # Install GitHub CLI brew install gh # Authenticate gh auth login # Sync your workspace git-same sync ``` Roadmap ## What's shipped. What's next. Git-Same 3.0 ships with full GitHub support, an interactive TUI, and signed and notarized macOS builds via Homebrew cask. Provider support for GitLab and Bitbucket is next. ### Shipped - GitHub support - Parallel cloning - Smart filtering - Progress bars - Interactive TUI mode - Workspace management ### Planned - Finder badges in macOS Finder - GitLab support - Bitbucket support - Repo groups - Web dashboard ## Install Git-Same and sync your workspace. Homebrew installs the binary and aliases. After that, run `git-same setup` once and `git-same sync` whenever your GitHub orgs change. brew install --cask zaai-com/tap/git-same [View on GitHub](https://github.com/ZAAI-com/git-same) [Read the docs](https://github.com/ZAAI-com/git-same/blob/main/docs/README.md)