Installation

Homebrew

brew tap git-pkgs/git-pkgs
brew install git-pkgs

Download binary

Download a prebuilt binary from the releases page.

Binaries are available for:

• macOS (Intel and Apple Silicon)
• Linux (amd64 and arm64)
• Windows (amd64)

Each release includes man pages in the archive. Copy them to your man path (e.g., /usr/local/share/man/man1/) to enable man git-pkgs.

Build from source

Requires Go 1.22 or later.

go install github.com/git-pkgs/git-pkgs@latest

Verify installation

git pkgs --version

Shell completions

Generate completions for your shell:

git pkgs completion bash > /etc/bash_completion.d/git-pkgs
git pkgs completion zsh > "${fpath[1]}/_git-pkgs"
git pkgs completion fish > ~/.config/fish/completions/git-pkgs.fish

Next steps

Initialize git-pkgs in a repository:

cd your-repo
git pkgs init

See Getting Started for a walkthrough of the main commands.