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

Repository files navigation

NOTICE

This branch was given a to ralph with the goal of writing tests, finding bugs, refactorign large files and potentially adding new features.

This is for experimenation purposes only and this branch might or might not be merged into the main branch.

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