Sitelet https://github.com/Matars/gitfetch/tree/stash
Skip to content
 
 

Repository files navigation

gitfetch

CI

A neofetch-style CLI tool for GitHub, GitLab, Gitea, Forgejo, Codeberg, and Sourcehut statistics. Display your profile and stats from various git hosting platforms in a beautiful, colorful terminal interface with extensive customization options and intelligent layout adaptation.

Note: This project is still maturing with only ~30 closed issues as of November 1st, 2025. If you encounter bugs, have feature requests, or want to contribute, please open an issue.

image image
2025-10-20-143110_hyprshot

Documentation

📖 Full Documentation

Quick Install

macOS (Homebrew)

brew tap matars/gitfetch
brew install gitfetch

Arch Linux (AUR)

yay -S gitfetch-python

From Source with pip

Make sure you have pip installed, then run:

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

Features

  • Neofetch-style display with ASCII art
  • Comprehensive statistics from multiple git hosting platforms
  • Encourages maintaining commit streaks
  • Get PR's and issues quick view in terminal
  • Smart SQLite-based caching system
  • Cross-platform support (macOS and Linux)
  • Extensive customization options
  • Experimental Rust TUI scaffold via gitfetch --tui

Experimental TUI (Rust)

gitfetch --tui launches an experimental Rust ratatui interface for daily git flow.

Current capabilities:

  • Live refresh (~700ms) of changed files and branch state
  • Stage/unstage a selected file
  • Create commit from inside the TUI
  • Push from inside the TUI

For local testing from this repository:

cargo run --manifest-path rust/gitfetch-tui/Cargo.toml
gitfetch --tui

You can also point to a custom TUI binary with GITFETCH_TUI_BIN.

Controls:

  • j / k or arrow keys: move selection
  • space or enter: stage/unstage selected file
  • c: open commit input modal
  • p: push
  • r: refresh now
  • q: quit

Supported Platforms

  • GitHub - Uses GitHub CLI (gh) for authentication
  • GitLab - Uses GitLab CLI (glab) for authentication
  • Gitea/Forgejo/Codeberg - Uses personal access tokens
  • Sourcehut - Uses personal access tokens

Uninstall

brew uninstall gitfetch          # Homebrew
brew untap matars/gitfetch     # Homebrew tap
pip uninstall gitfetch          # pip
yay -R gitfetch-python          # AUR (yay)

License

GPL-2.0

About

A neofetch alternative for GitHub quick view

Topics

Resources

Contributing

Stars

396 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors

Languages