Git-Same

Mirror your GitHub org structure to the local filesystem: parallel clone, incremental sync, CLI, TUI dashboard, and a macOS Tauri app with Finder badges and workspace folder icons.

What It Does

+--------------------------------------+------------+------------------------------------+
│ GITHUB PLATFORM                      │    Sync    │ LOCAL FILE SYSTEM                  │
│ github.com                           │            │ /users/m/same-github/              │
+--------------------------------------+------------+------------------------------------+
│ github.com/manuelgruber              │   <<==>>   │ manuelgruber/                      │
│ github.com/manuelgruber/.github      │   <<==>>   │ manuelgruber/.github/              │
│ github.com/manuelgruber/dotfiles     │   <<==>>   │ manuelgruber/dotfiles/             │
+--------------------------------------+------------+------------------------------------+
│ github.com/zaai-com                  │   <<==>>   │ zaai-com/                          │
│ github.com/zaai-com/powernight       │   <<==>>   │ zaai-com/powernight/               │
│ github.com/zaai-com/clean-autofill   │   <<==>>   │ zaai-com/clean-autofill/           │
│ github.com/zaai-com/git-same         │   <<==>>   │ zaai-com/git-same/                 │
│ github.com/zaai-com/jekyll-aeo       │   <<==>>   │ zaai-com/jekyll-aeo/               │
+--------------------------------------+------------+------------------------------------+
│ github.com/company1                  │   <<==>>   │ company1/                          │
│ github.com/company1/example.ai       │   <<==>>   │ company1/example.ai/               │
+--------------------------------------+------------+------------------------------------+
│ 3 orgs · 7 repos                     │            │ 3 dirs · 7 repos                   │
+--------------------------------------+------------+------------------------------------+

One command discovers every repo across your GitHub orgs and mirrors them locally, cloning new repos in parallel, fetching updates for existing ones, and skipping repos with uncommitted changes. On macOS, the cask also installs Git-Same.app, FinderSync badges, and a monitor LaunchAgent so workspace status is visible in Finder.

Installation

macOS (signed + notarized cask):

brew install --cask zaai-com/tap/git-same

Linux and headless macOS (formula):

brew install zaai-com/tap/git-same-cli

The macOS cask ships the Tauri GUI app, Finder badges, monitor LaunchAgent, and CLI aliases. brew upgrade --cask git-same keeps the app and command-line tools current together.

Other installation methods

From crates.io

cargo install git-same

GitHub Releases

Download pre-built assets from GitHub Releases. Linux and headless macOS CLI builds are .tar.gz archives named git-same-<version>-<target-triple>.tar.gz (for example, git-same-3.1.0-aarch64-apple-darwin.tar.gz). macOS GUI builds are signed and notarized DMGs named git-same-<version>-<arch>.dmg.

Quick Start

Interactive (TUI)

git-same

Launches the full terminal UI with dashboard, sync, status, and workspace management, all via keyboard shortcuts.

CLI

git-same init          # 1. Create user config
git-same setup         # 2. Configure workspace (interactive wizard)
git-same sync          # 3. Clone new repos, fetch/pull existing
git-same status        # 4. Check repo status across orgs

Commands

Command	Description
`git-same init`	Create config file with sensible defaults
`git-same setup`	Interactive wizard to configure a workspace
`git-same sync`	Discover, clone new, fetch/pull existing repos
`git-same status`	Show git status across all local repos
`git-same workspace`	List workspaces, set default
`git-same reset`	Remove all config, workspaces, and cache
`git-same monitor`	Run or inspect the background status monitor
`git-same refresh`	Ask the running monitor to rescan immediately
`git-same scan`	Discover repos without cloning or syncing

`git-same init`

Initialize git-same configuration:

git-same init [-p <config-path>] [-f | --force]

Creates a config file at ~/.config/git-same/config.toml with sensible defaults.

`git-same setup`

Configure a workspace (interactive wizard):

git-same setup [--name <NAME>]

Walks through provider selection, authentication, org filters, and base path.

`git-same sync`

Sync repositories: discover, clone new, fetch/pull existing:

git-same sync [OPTIONS]

Options:
  -w, --workspace <WORKSPACE> Workspace to sync (path or unique folder name)
      --pull                  Use pull instead of fetch for existing repos
  -n, --dry-run               Show what would be done
  -c, --concurrency <N>       Number of parallel operations (1-32)
      --refresh               Force re-discovery (ignore cache)
      --no-skip-uncommitted         Don't skip repos with uncommitted changes

Discovering repos

Cloning & fetching

Completed

`git-same status`

Show status of local repositories:

git-same status [OPTIONS]

Options:
  -w, --workspace <WORKSPACE> Workspace to check (path or unique folder name)
  -o, --org <ORG>...          Filter by organization (repeatable)
  -d, --uncommitted                 Show only repositories with uncommitted changes
  -b, --behind                Show only repositories behind upstream
      --detailed              Show detailed status information

`git-same workspace`

Manage workspaces:

git-same workspace list              # List configured workspaces
git-same workspace default [WORKSPACE] # Set default workspace (path or unique folder name)
git-same workspace default --clear   # Clear default workspace

`git-same reset`

Remove all config, workspaces, and cache:

git-same reset [-f | --force]

`git-same monitor`

Run the status monitor used by the macOS Finder extension and app:

git-same monitor [OPTIONS]

Options:
      --foreground       Legacy flag; the monitor runs in the foreground today
      --interval <SECS>  Polling interval, overriding config.toml
      --status           Show monitor status
      --stop             Stop a running monitor

The Homebrew cask installs a LaunchAgent that runs the monitor for you. Non-cask installs can run git-same monitor directly when Finder badge or app status updates are needed. The older daemon subcommand remains as a compatibility alias.

`git-same refresh`

Ask the running monitor to rewrite Finder/app status immediately:

git-same refresh [--path <DIR>]

Use this after manually changing workspace folders, deleting repos, or debugging Finder badges. Without --path, every monitored workspace is refreshed.

`git-same scan`

Scan a directory tree for existing workspace markers:

git-same scan [PATH] [--depth <N>] [--register]

Use --register to add discovered workspaces to your config automatically.

Aliases

Git-Same installs multiple binary names so you can use whichever you prefer:

Command	Description
`git-same`	Primary binary (always available)
`gitsame`	No-hyphen alias (symlink)
`gitsa`	Short alias (symlink)
`gisa`	Shortest alias (symlink)
`git same`	Git subcommand (requires git-same in PATH)

Install method differences: Homebrew cask (brew install --cask zaai-com/tap/git-same) and the headless formula (brew install zaai-com/tap/git-same-cli) both install all aliases automatically. cargo install git-same installs only the primary binary.

All examples in this README use git-same, but any alias works interchangeably.

macOS App and Finder Badges

The cask installs Git-Same.app, the CLI aliases, a FinderSync badge extension, and a monitor LaunchAgent. The app reads the same config as the CLI and shows workspace status from the monitor. Finder badges use the monitor's status file, and workspace root folders get a custom Git-Same folder icon unless [ui] custom_folder_icon = false is set.

Useful checks:

gisa monitor --status   # Check whether the monitor is running
gisa refresh            # Force an immediate status refresh
gisa monitor --stop     # Stop a running monitor

If Finder reserves badge space but no Git-Same badges render, check System Settings -> Login Items & Extensions. Google Drive's FinderSync extension can prevent peer badge images from appearing; disabling Google Drive's Finder extension has been the confirmed workaround in affected environments.

Requirements

Git-Same depends on two external tools at runtime:

git: Git-Same shells out to git for all repository operations (clone, fetch, pull, and status). Without it, no git operations can run.
gh (GitHub CLI): Git-Same calls gh auth token to obtain GitHub API tokens for repo discovery and gh api user to resolve your username. Without it, Git-Same cannot authenticate with the GitHub API.

Installing and authenticating `gh`

# Install GitHub CLI
brew install gh  # macOS
# or: sudo apt install gh  # Ubuntu

# Authenticate
gh auth login

# Git-Same will now use your gh credentials
git-same sync

TUI Mode

Running git-same without a subcommand launches the interactive terminal UI.

Screens

Screen	Purpose	Key bindings
Dashboard	Overview with status tabs, search, and sync actions	`s`: Start sync, `p`: Show sync progress, `t`: Refresh status, `w`: Workspaces, `e`/`i`: Settings, `/`: Search repositories, `[←]`/`[→]`: Switch tabs, `[↑]`/`[↓]`: Move within tab, `Enter`: Open selected repo folder
Workspace Selector	Pick, inspect, and create workspaces	`[←]`/`[→]` or `Tab`: Switch pane, `[↑]`/`[↓]`: Move or scroll, `Enter`: Select workspace or create new, `d`: Set default, `n`: New workspace, `c`: Expand/collapse config, `f`: Open folder
Setup Wizard	Interactive workspace configuration	Step-by-step prompts for requirements, provider, authentication, orgs, path, and confirmation
Sync Progress	Live sync progress and post-sync results	`p`/`Esc`: Hide or go back, `[←]`/`[→]`: Switch result filters when finished, `[↑]`/`[↓]`: Move or scroll, `a`: All, `u`: Updated, `f`: Failed, `x`: Skipped, `c`: Changelog, `h`: History, `Enter`: Expand selected repo commit detail
Settings	View requirements and adjust run options	`Tab`/`[↑]`/`[↓]`: Move, `c`: Open config folder, `d`: Toggle dry run, `m`: Toggle fetch/pull mode, `Esc`: Back

Examples

Sync all repositories in default workspace

git-same sync

Sync with pull mode for a specific workspace

git-same sync --workspace work --pull

Check which repositories have uncommitted changes

git-same status --uncommitted

Dry run to see what would be synced

git-same sync --dry-run

License

MIT License - see LICENSE for details

Roadmap

Building from source or contributing? See DEVELOPMENT.md.

Name		Name	Last commit message	Last commit date
Latest commit History 276 Commits
.claude		.claude
.conductor		.conductor
.github		.github
crates		crates
docs		docs
macos		macos
toolkit		toolkit
.gitignore		.gitignore
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
LICENSE		LICENSE
rust-toolchain.toml		rust-toolchain.toml
rustfmt.toml		rustfmt.toml

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

Git-Same

What It Does

Installation

From crates.io

GitHub Releases

Quick Start

Commands

git-same init

git-same setup

git-same sync

git-same status

git-same workspace

git-same reset

git-same monitor

git-same refresh

git-same scan

Aliases

macOS App and Finder Badges

Requirements

Installing and authenticating gh

TUI Mode

Screens

Examples

Sync all repositories in default workspace

Sync with pull mode for a specific workspace

Check which repositories have uncommitted changes

Dry run to see what would be synced

License

Roadmap

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 4

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

`git-same init`

`git-same setup`

`git-same sync`

`git-same status`

`git-same workspace`

`git-same reset`

`git-same monitor`

`git-same refresh`

`git-same scan`

Installing and authenticating `gh`

Packages