Installation

gitfetch can be installed on macOS, Linux, and Windows. During first-run setup, you’ll be guided to install and authenticate with the necessary CLI tools or provide access tokens for your chosen git hosting platform.

Quick Install (Standalone Binary)

Download the latest binary for your platform from the releases page:

Platform	Asset
Linux x86_64	gitfetch-linux-x86_64
macOS (Apple Silicon)	gitfetch-macos-arm64
Windows x86_64	gitfetch-windows-x86_64.exe

# Linux / macOS
chmod +x gitfetch-*
./gitfetch-linux-x86_64

No Python, no package manager required.

macOS (Homebrew)

brew tap matars/gitfetch
brew install gitfetch

Arch Linux (AUR)

yay -S gitfetch-python

Or with other AUR helpers:

paru -S gitfetch-python
trizen -S gitfetch-python

Or manual build:

git clone https://aur.archlinux.org/gitfetch-python.git
cd gitfetch-python
makepkg -si

NixOS (Flake only)

Installation:

To install, you should add an input to your flake:

gitfetch.url = "github:Matars/gitfetch";

Minimal flake variant for it to work:

{
  description = "My awesome flake";

	inputs = {
	  nixpkgs.url = "github:NixOS/nixpkgs/nixos-25.05"; # or your version
	  gitfetch.url = "github:Matars/gitfetch";
	};
  outputs = inputs@{ self, nixpkgs, gitfetch }:
  	let
  		system = "x86_64-linux";
  		pkgs = import nixpkgs { 
  		  inherit system; 
  		};
  	in {
  	  nixosConfigurations = {
  	  	nixos = nixpkgs.lib.nixosSystem {
  	  	  specialArgs = { inherit system; inherit inputs; };
		  modules = [
		    ./configuration.nix
		  ];
  	  	};
  	  };
  	};
}

Then in environment.systemPackages add this:

environment.systemPackages = with pkgs; [
	# ...
	inputs.gitfetch.packages.${system}.default # your actual input name
	gh # don't forget to install it and authenticate
]

Updating

To update, run these commands and then rebuild

nix flake update gitfetch # gitfetch should be replaced by your input name in the flake
nixos-rebuild switch

From Source

With pip

Make sure you have pip installed, then run:

git clone https://github.com/Matars/gitfetch.git
cd gitfetch
make dev

With uv

uv tool install git+https://github.com/Matars/gitfetch

With pipx

pipx install git+https://github.com/Matars/gitfetch

First-run Setup

When you run gitfetch for the first time, you’ll be prompted to:

1. Choose your git hosting provider (GitHub, GitLab, Gitea/Forgejo/Codeberg, or Sourcehut)
2. Install required CLI tools (if using GitHub or GitLab)
3. Authenticate with your chosen platform
4. Configure access tokens (if using Gitea/Forgejo/Codeberg or Sourcehut)

The setup process will provide helpful error messages and installation instructions if anything is missing.

Uninstall

Standalone Binary

rm gitfetch-linux-x86_64   # or whichever binary you downloaded

Homebrew

brew uninstall gitfetch          # Uninstall gitfetch
brew untap matars/gitfetch       # Remove the tap

pip

pip uninstall gitfetch

uv

uv tool uninstall gitfetch

pipx

pipx uninstall gitfetch

AUR (Arch Linux)

yay -R gitfetch-python

Or with other AUR helpers:

paru -R gitfetch-python
trizen -R gitfetch-python

NixOS

Remove the gitfetch input from your flake and remove it from environment.systemPackages.