Features & Usage

gitfetch brings the magic of neofetch to your git hosting platforms, displaying your coding activity in a stunning, colorful terminal interface that’s both beautiful and highly customizable.

Core Features

Neofetch-style display with stunning ASCII art that brings your stats to life
Comprehensive statistics from GitHub, GitLab, Gitea, Forgejo, Codeberg, and Sourcehut
Smart SQLite-based caching system for lightning-fast subsequent runs
Cross-platform support (macOS, Linux, and Windows) - works wherever you code
View active pull requests and issues - stay on top of your contributions
Display commit streak information - track your coding momentum
Local repository analysis - show contribution graphs from your local .git
Git timeline view - visualize commit history over time
ASCII art simulation - create pixel art from text or use predefined shapes
Extensive customization options that let you make it truly yours

Visual Customization

Transform your gitfetch display with powerful visual options:

Custom contribution characters - use any symbol or emoji for your graph blocks
Dynamic section control - hide/show achievements, languages, issues, PRs, and more
Flexible dimensions - adjust width and height to fit your terminal perfectly
ASCII art simulation - create pixel art from text or use predefined shapes like kitty, cat, heart, and star
Advanced color customization with hex codes and predefined color schemes

🧠 Intelligent Layout System

gitfetch automatically adapts to your terminal environment:

Full Layout: Complete information display when you have 120+ columns
Compact Layout: Side-by-side graph and stats for medium terminals
Minimal Layout: Clean contribution graph for narrow screens

The system intelligently considers both terminal width AND height to deliver the optimal viewing experience, no matter your setup.

Basic Usage

Use default username (from config):

gitfetch

Fetch stats for specific user:

gitfetch username

Repository-Specific Stats

Display contribution statistics for the current local git repository:

gitfetch --local

Shows commit activity over the last year, built from local git history. No internet or authentication needed — just a local .git directory.

Current Limitations:

No repository metadata (stars, forks, issues, etc.)
No language statistics for the repository
Limited to local git history analysis
Achievements and streaks are calculated from local commits only

Git Timeline

Show a git commit timeline instead of the contribution graph:

gitfetch --graph-timeline

Works with both remote and local mode. When combined with --local, the timeline is built from your local .git history.

Configuration

Change the configured git provider:

gitfetch --change-provider

Visual Customization

Contribution Characters

gitfetch --custom-box "██"
gitfetch --custom-box "■"
gitfetch --custom-box "●"
gitfetch --custom-box "*"
gitfetch --custom-box "◆"
gitfetch --custom-box "◉"

Predefined Shapes

gitfetch --shape kitty
gitfetch --shape heart_shiny

Display multiple shapes with vertical spacing:

gitfetch --shape kitty heart_shiny
gitfetch --shape heart kitty

Available Shapes

gitfetch includes the following predefined shapes:

kitty - A cute cat face
oneup - Classic Super Mario mushroom power-up
oneup2 - Alternative mushroom design
hackerschool - Hacker School logo
octocat - GitHub’s Octocat mascot
octocat2 - Alternative Octocat design
hello - “HELLO” text
heart1 - Simple heart shape
heart2 - Alternative heart design
heart - Standard heart shape
heart_shiny - Heart with sparkle effect
hireme - “HIRE ME” text
beer - Beer mug design
gliders - Conway’s Game of Life glider pattern

Graph Dimensions

gitfetch --width 50 --height 5  # 50 chars wide, 5 days high
gitfetch --width 100            # Custom width, default height
gitfetch --height 3             # Default width, 3 days high

Hide Elements

gitfetch --no-date              # Hide month/date labels
gitfetch --graph-only           # Show only contribution graph
gitfetch --no-achievements      # Hide achievements
gitfetch --no-languages         # Hide languages
gitfetch --no-issues            # Hide issues section
gitfetch --no-pr               # Hide pull requests
gitfetch --no-account          # Hide account info
gitfetch --no-grid             # Hide contribution grid

Text Simulation

Display text as a contribution graph pattern:

gitfetch --text "HELLO"
gitfetch --text "GIT"

Text is rendered using pixel font patterns. Only uppercase letters, digits, and some symbols are supported.

Combined Options

gitfetch --no-date --no-achievements --custom-box "█" --width 60

Cache Options

Bypass cache and fetch fresh data:

gitfetch username --no-cache

Clear cache:

gitfetch --clear-cache

Layout Control

gitfetch automatically adapts to your terminal size, but you can control spacing:

gitfetch --spaced     # Enable spaced layout
gitfetch --not-spaced # Disable spaced layout

Help

See all available options:

gitfetch --help