ghfetch

GitHub stats in the terminal, neofetch-style.

ghfetch renders compact terminal cards for GitHub users, repositories, and organizations, with optional JSON output for scripting.

Features

• User, repository, and organization views
• Catppuccin-based terminal themes
• Optional JSON output for shell scripts and other tooling
• Language breakdowns with detailed table mode
• Contribution and streak stats when authenticated

Installation

From crates.io

cargo install ghfetch

From source

git clone https://github.com/OneNoted/ghfetch.git
cd ghfetch
cargo install --path .

Authentication

ghfetch checks for authentication in this order:

1. --token
2. GITHUB_TOKEN
3. GH_TOKEN
4. gh auth token

Unauthenticated mode still works for public data, but GitHub rate limits are much lower and contribution data is unavailable.

Usage

ghfetch octocat
ghfetch user octocat --all
ghfetch repo rust-lang/rust
ghfetch org rust-lang --languages
ghfetch octocat --json
ghfetch repo rust-lang/rust --theme latte

Commands

• ghfetch [username]
• ghfetch user <username>
• ghfetch repo <owner/repo>
• ghfetch org <orgname>

Common flags

• --json prints structured output instead of a card
• --no-color disables ANSI styling
• --theme <mocha|macchiato|frappe|latte> selects the card palette
• --verbose prints API request diagnostics to stderr

Notes

• ghfetch user <username> shows a compact summary by default. Use --all to include every section, or specific section flags like --repos or --languages.
• ghfetch org <orgname> and ghfetch repo <owner/repo> show language summaries by default.
• Detailed language mode (--languages) prints a wider table instead of the card view.

Development

cargo fmt --check
cargo clippy --all-targets --all-features -- -D warnings
cargo test

License

MIT. See LICENSE.