Homebrew

brew install ptmaroct/tap/lfg          # stable
brew install ptmaroct/tap/lfg-beta     # preview channel — fastest moving

The tap is auto-published by goreleaser on every release. Stable and beta install side-by-side as different formulae; pick one or both. Upgrade with brew upgrade ptmaroct/tap/lfg (or …/lfg-beta).

One-liner

curl -fsSL https://raw.githubusercontent.com/ptmaroct/lfg/main/install.sh | sh

Drops lfg in /usr/local/bin (or ~/.local/bin when /usr/local/bin isn't writable). After install, run lfg to launch the TUI.

Pin a version or change the prefix

LFG_VERSION=v0.3.0 LFG_PREFIX=$HOME/.local sh install.sh

Var	Default	Notes
LFG_VERSION	latest GitHub release	Must match a published tag, e.g. v0.3.0.
LFG_PREFIX	/usr/local or $HOME/.local	Binary lands in <prefix>/bin/lfg.

The script picks the right tarball for your uname -s / uname -m combo (Darwin/Linux × amd64/arm64) from the goreleaser release.

From source

Requires Go 1.25+:

git clone https://github.com/ptmaroct/lfg
cd lfg
go build -o lfg ./cmd/lfg
./lfg

make build is the same thing wrapped in a Makefile target, plus it sets the version ldflags so lfg version --verbose returns the correct git SHA.

Self-update

Already have lfg? Skip the curl step:

lfg update

Pulls the latest release from GitHub via minio/selfupdate. See the self-update guide for details.

Verify

lfg version --verbose

Should print the version, git SHA, build date, Go version, and target platform.

Uninstall

lfg doesn't install a daemon, doesn't write to system directories, and doesn't drop config until you launch it for the first time. Uninstalling is two rms:

brew uninstall ptmaroct/tap/lfg   # if installed via brew
rm $(command -v lfg)              # otherwise: remove binary
rm -rf ~/.config/lfg              # state, logs, key, config

The # lfg-managed PATH block in your shell rc files can be deleted by hand — search for # lfg-managed PATH in ~/.bashrc, ~/.zshrc, and any fish config.