RepoMate 🧉

A command-line tool to manage and synchronize multiple git repositories. This tool helps you maintain a list of git repositories and keep them up to date with their remote sources.

• Maintain a list of repositories to sync
• Parallel syncing, with a live progress bar for every repository in flight
• Add and remove repositories from the sync list
• Automatically clone new repositories
• Update existing repositories
• Pattern-based filtering for selective syncing
• Support for multiple shells (bash, fish, zsh)
• Configurable paths for code and configuration storage

gem install repomate

1. Clone the repository:

git clone git@github.com:alex-quiterio/repomate.git
cd repomate

2. Install dependencies:

bundle install

3. Build and install the gem:

gem build repomate.gemspec
gem install repomate-*.gem

Choose the appropriate shell integration for enhanced functionality:

mkdir -p ~/.config/fish/functions
cp shell/fish/repomate.fish ~/.config/fish/functions/

# Add to your ~/.zshrc
source /path/to/repomate/shell/zshell/repomate.zshell

# Add to your ~/.bashrc or ~/.bash_profile
source /path/to/repomate/shell/bash/repomate.bash

The tool can be used directly from the command line after installation.

# List all repositories in the sync list
repomate list

# Sync all repositories
repomate sync

# Sync repositories matching a pattern
repomate sync -p "myproject"

# Sync with a given number of repositories in flight at once
repomate sync -j 4

# Add a repository to the sync list
repomate add -l "git@github.com:alex-quiterio/repomate.git"

# Remove a repository from the sync list
repomate remove -l "git@github.com:alex-quiterio/repomate.git"

• -l, --repo-url URL: Specify a repository URL (for add/remove)
• -p, --pattern PATTERN: Filter repositories by pattern (for sync/list)
• -j, --jobs JOBS: Number of repositories to sync in parallel (for sync, default: twice the machine's processor count, capped at 16)
• -h, --help: Show help information
• -v, --version: Show version information

The configuration file is a simple text file with one repository URL per line. For example:

git@github.com:user/repo1.git
git@github.com:user/repo2.git
git@github.com:organization/repo3.git

The file will be automatically created at $HOME/code/.subscribed-repos if it doesn't exist.

• When syncing repositories:

  • Repositories are synced in parallel, up to --jobs at a time
  • Without --jobs, the default is twice the machine's processor count, capped at 16: git is mostly network-bound so cores can oversubscribe, but the uplink and the terminal height (one bar per repository in flight) do not grow with the core count
  • Each repository in flight shows its own progress bar, fed by git's own progress output
  • Finished repositories print a single result line above the bars
  • When the output is not a terminal (CI, pipes), only the result lines are printed
  • If a repository doesn't exist locally, it will be cloned
  • If a repository exists locally, it will be updated (git pull)
  • Updates are performed on the default branch (main/master)
  • Handles uncommitted changes by stashing them temporarily during updates
  • Supports pattern-based filtering to sync only matching repositories

• When adding repositories:

  • Duplicate repositories are not allowed
  • The URL is validated before adding
  • Repository is automatically cloned after being added to the list

• When removing repositories:

  • Repository URL is removed from the sync list
  • Local repository files are also deleted from disk

• Configuration:

  • Default code directory: $HOME/code
  • Default config file: $HOME/code/.subscribed-repos
  • Directories are created automatically if they don't exist

• Ruby 2.6.0 or higher
• Git
• Optional: Fish, Zsh, or Bash shell (for enhanced shell integration)

To see all available options and commands:

repomate --help