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
liberty-prime clean issue2287 git@github.com:bos/liberty-prime.git
neloth unclean patch git@github.com:telvanni/neloth.git
synth clean main https://github.com/railroad/synth.git
This app displays relevant information for multiple Git repositories in one, or multiple, 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.
You can use macOS Homebrew or Linuxbrew to install the tap.
sh
brew install nickgerace/gfold/gfold
You can use a Linux distribution that supports installing packages from the AUR to install: gfold (builds from source) and/or gfold-git (VCS/development package). 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
It is highly recommended to run strip against the binary on compatible systems to reduce executable size.
sh
TEMP=$(command -v gfold) && du -h $TEMP && strip $TEMP && du -h $TEMP
The above script will exit with a non-zero exit code if
gfoldis not installed and/or is not in yourPATH.
Pass in the -h, or --help, flag to see all the options for using this application.
sh
gfold
gfold ..
gfold $HOME
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.
gfld?gfld was an experimental, minimal version of gfold.
It was intended to potentially replace gfold, but has since been removed.
All optimizations and lessons learned from the project have since been integrated into gfold.
Check out the removal issue to learn more.
This repository follows and enforces the Rust programming language's Code of Conduct.