gfold(1)

🦋 gfold(1) — General Commands Manual, but make it bestie 🌈

okay so welcome to gfold(1), bestie — yes, the General Commands Manual one. This is the page for gfold, and it’s genuinely iconic for keeping your Git repos in check. Let’s get into it 💅

---

💖 NAME 💖

gfold is the main character here. More information: https://github.com/nickgerace/gfold.

description: this application helps you keep track of multiple Git repositories via CLI. By default, it displays relevant information for all repos in the current working directory.

config file usage: CLI options are prioritized, but default options will fallback to the config file if it exists. Here are the config file lookup locations, no cap:

$XDG_CONFIG_HOME/gfold.toml
$XDG_CONFIG_HOME/gfold/config.toml
$HOME/.config/gfold.toml (or {{FOLDERID_Profile}}\.config\gfold.toml on Windows)

---

✨ SYNOPSIS ✨

okay so the shape of it is literally this:

gfold [-c|--color-mode] [-d|--display-mode] [--dry-run] [--generate-man] [-i|--ignore-config-file] [-v|--verbose]... [-q|--quiet]... [-h|--help] [-V|--version] [PATHS]

---

🌸 DESCRIPTION 🌸

More information: https://github.com/nickgerace/gfold.

description: this application helps you keep track of multiple Git repositories via CLI. By default, it displays relevant information for all repos in the current working directory.

config file usage: CLI options are prioritized, and default options will fallback to the config file if it exists. The lookup locations are giving very specific file-path energy:

$XDG_CONFIG_HOME/gfold.toml
$XDG_CONFIG_HOME/gfold/config.toml
$HOME/.config/gfold.toml (or {{FOLDERID_Profile}}\.config\gfold.toml on Windows)

---

🎀 OPTIONS 🎀

• -c, --color-mode <COLOR_MODE> — configure the color settings. possible values are:
  • always — attempt to display colors as intended (default behavior)
  • compatibility — display colors using widely-compatible methods at the potential expense of colors being displayed as intended
  • never — never display colors
• -d, --display-mode <DISPLAY_MODE> — configure how collected information is displayed. possible values are:
  • classic — informs the caller to display results in the classic format
  • json — informs the caller to display results in JSON format
  • standard — informs the caller to display results in the standard (default) format. all results are sorted alphabetically and then sorted by status
  • standard-alphabetical — informs the caller to display results in the standard (default) format with a twist: all results are solely sorted alphabetically (i.e. no additional sort by status)
• --dry-run — display finalized config options and exit (merged options from an optional config file and command line arguments)
• --generate-man — generate a man page for gfold
• -i, --ignore-config-file — ignore config file settings
• -v, --verbose — increase logging verbosity
• -q, --quiet — decrease logging verbosity
• -h, --help — print help (see a summary with -h)
• -V, --version — print version
• [PATHS] — specify path(s) to target directories (defaults to current working directory)

---

🍓 VERSION 🍓

v2026.3.0 — that’s the version, bestie ✨

---

cute sign-off: this was gfold(1) from the General Commands Manual, source/version gfold 2026.3.0, version v2026.3.0; the footer didn’t list a date, so no invented date — just vibes 💖🎀