Install▊

Requirements

• Node.js ≥ 18 (only the runtime — the package has zero npm dependencies)
• the git binary on PATH
• no other installs; no network access needed at runtime

npm (global)

npm install -g @maliqkara/gitcleanup
git-cleanup --version

Homebrew

brew tap Asunachi/git-cleanup
brew install git-cleanup

The formula is pinned to the published npm tarball by sha256 and re-verified by the tap's daily poll, so the Homebrew build always matches the bytes on the registry.

npx (no install)

npx -y @maliqkara/gitcleanup scan

From source

git clone https://github.com/Asunachi/git-cleanup.git
cd git-cleanup
npm link          # or: node bin/git-cleanup.mjs scan

Shell integration (optional)

git-cleanup completions bash > ~/.local/share/bash-completion/completions/git-cleanup
git-cleanup shell-hook bash >> ~/.bashrc        # auto-scan on every cd
git-cleanup shell-hook pre-commit > .git/hooks/pre-commit   # remind on commit

Completions ship for bash, zsh, and fish. The shell hook prints a prompt snippet that runs a quick scan --summary whenever you enter a repo; the pre-commit hook reminds you about prunable branches without blocking the commit. See the README for the exact install lines per shell.

Uninstall

npm uninstall -g @maliqkara/gitcleanup     # npm
brew uninstall git-cleanup                # Homebrew
rm -rf ~/.config/git-cleanup              # config + report history