Getting Started

Prerequisites

  • git and jq (required)
  • bash 4+ (default on all modern Linux distros and macOS)
  • At least one provider CLI: gh, glab, tea, bitbucket, or rad

Install dependencies by distro

Distro Command
Arch / CachyOS / Manjaro sudo pacman -S git jq github-cli
Debian / Ubuntu / Mint sudo apt install git jq gh
Fedora / RHEL / CentOS sudo dnf install git jq gh
openSUSE sudo zypper install git jq gh
Alpine apk add git jq github-cli
Void Linux sudo xbps-install git jq github-cli
Gentoo emerge dev-vcs/git app-misc/jq dev-util/github-cli
macOS (Homebrew) brew install git jq gh

Installation

Make (recommended)

Works on any Linux distro or macOS with git, make, and bash:

git clone git@github.com:Dxsk/repos-manager.git
cd repos-manager
make install

This installs to ~/.local/bin/repos-manager. Change the prefix with:

make install PREFIX=/usr/local

Manual

Source the file for your shell:

# bash
source sourceme.bash

# zsh
source sourceme.zsh

# fish
source sourceme.fish

Nix

nix run github:Dxsk/repos-manager -- github sync

First sync

# Authenticate with your providers
repos-manager login

# Sync all repos
repos-manager sync --all

After syncing, your repos are organized as:

~/Documents/
  github.com/
    your-user/
      repo-1/
      repo-2/
    your-org/
      project/
  gitlab.com/
    ...

Verify

# Check status of all repos
repos-manager status