gfold is a CLI application that helps you keep track of multiple Git repositories.
bash
user at hostname in ~/git
% gfold
great-journey unclean main git@github.com:truth/great-journey.git
installation-zero bare main https://github.com/the-ark/installation-zero.git
sierra unpushed dev https://github.com/forward-unto-dawn/sierra.git
spark clean issue343 git@github.com:guilty/spark.git
tartarus unclean delta git@github.com:covenant/tartarus.git
voi clean main https://github.com/earth/voi.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 in 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.
bash
brew install nickgerace/gfold/gfold
If using a Linux distribution that supports installing packages from the AUR, you can install from three packages: gfold (builds from source), gfold-bin (uses the GitHub release binary), and 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.
bash
yay -S gfold
paru -S gfold
You can install the crate on any platform with cargo.
bash
cargo install gfold
Keeping the crate up to date is easy with cargo-update.
sh
cargo install cargo-update
cargo install-update -a
You can obtain gfold via the latest GitHub release.
Once you have it downloaded, you can add it to your PATH.
You may have to reload your shell in order to see gfold in your PATH.
bash
chmod +x gfold
mv gfold /usr/local/bin/
You can use symbolic links to swap between versions, and manage multiple at a time.
With this workflow, you can add/remove versions of the binary from /usr/local/gfold/, and change the symbolic link as needed.
```bash wget https://github.com/nickgerace/gfold/releases/download/$VERSION/gfold-$PLATFORM mv gfold-$PLATFORM gfold-$VERSION chmod +x gfold-$VERSION
mkdir /usr/local/gfold/ mv gfold-$VERSION /usr/local/gfold/ ln -s /usr/local/gfold/gfold-$VERSION /usr/local/bin/gfold ```
For all the ways on how to use this application, pass in the -h, or --help, flag.
bash
gfold --help
Here are some example invocations...
bash
gfold
gfold ..
gfold $HOME
gfold /this/is/an/absolute/path
gfold ../../this/is/a/relative/path
gfold ~/path/to/multiple/repositories/ -r
gfold -r $HOME/path/to/multiple/repositories
gfold, and its external crates, support all three major desktop platforms.
It is tested for the latest versions of the following systems, but may work on more...
linux-gnu-amd64darwin-amd64windows-amd64Please check out CHANGELOG.md for more information. It follows the Keep a Changelog format.
This repository follows and enforces the Rust programming language's Code of Conduct.