gfold is a CLI-driven application that helps you keep track of multiple Git repositories.
sh
% gfold
astrid unclean main git@github.com:db/astrid.git
fev bare main https://github.com/institute/fev.git
gb unpushed dev https://github.com/hrothgar/gb.git
neloth unclean patch git@github.com:telvanni/neloth.git
pam clean main https://github.com/onc/pam.git
prime clean issue2287 git@github.com:bos/prime.git
This app displays relevant information for multiple Git repositories in one to many directories. While this tool might seem limited in scope and purpose, that is by design.
It prints each repository in alphabetical order, and pads each result based on the longest directory, branch, and status string.
By default, gfold looks at every Git repository via traversal from the current working directory.
However, if you would like to target another directory, you can pass that path (relative or absolute) as the first argument.
There are multiple methods for installing gfold.
You can use Homebrew to install the tap.
sh
brew install nickgerace/nickgerace/gfold
Notes:
- The original tap will no longer be maintained after version 2.0.1. Please migrate to the new tap.
- Both the current and deprecated taps may not work with Linuxbrew.
You can use a Linux distribution that supports installing packages from the AUR, Arch User Respository, to install the following:
Many people choose to use an AUR helper, such as yay or paru, in order to install their AUR packages.
sh
yay -S gfold
paru -S gfold
You can use cargo to install the crate on almost any platform.
sh
cargo install gfold
Keeping the crate up to date is easy with cargo-update.
sh
cargo install cargo-update
cargo install-update -a
If you do not want to use one of the above installation methods, you can download a binary from the releases page.
The following convenience script can be used on macOS and Linux amd64 systems (requires wget, jq, and curl to be installed):
sh
(
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
if [ "$OS" = "linux" ]; then OS=linux-gnu; fi
LATEST=$(curl -s https://api.github.com/repos/nickgerace/gfold/releases/latest | jq -r ".tag_name")
wget -O gfold https://github.com/nickgerace/gfold/releases/download/$LATEST/gfold-$OS-amd64
chmod +x gfold
sudo mv gfold /usr/local/bin/gfold
)
Note: the above convenience script does not verify the binary with a checksum. Discretion is advised.
Pass in the -h, or --help, flag to see all the options for using this application.
sh
gfold
gfold ..
gfold $HOME
gfold ~/
gfold /this/is/an/absolute/path
gfold ../../this/is/a/relative/path
gfold is intended to be ran on any tier one Rust target.
Please file an issue if your platform is unsupported.
If fold from GNU Coreutils is installed on macOS via brew, it will be named gfold.
You can avoid this collision with shell aliases, shell functions, and/or PATH changes.
Here is an example with the o dropped from gfold:
sh
alias gfld=$HOME/.cargo/bin/gfold