gitraffe

README

🦒 Gitraffe

A beautiful text-based UI git graph command line tool built with Golang, Bubble Tea, go-git, and Lip Gloss.

Features

• 📊 Visual git commit graph in your terminal (branches and tags are shown; the graph expands to use available space and long branch names are truncated as needed)
• 🎨 Beautiful styling with Lip Gloss
• ⌨️ Keyboard navigation (arrow keys, vim-style)
• 🖱️ Mouse wheel scrolling support
• 📱 Cross-platform (Linux, macOS, Windows)
• 🚀 Fast and lightweight

Installation

From Source

go install github.com/sevenam/gitraffe@latest

Or clone and build:

git clone https://github.com/sevenam/gitraffe.git
cd gitraffe
go build -o gitraffe main.go

Usage

Navigate to a git repository and run:

gitraffe

Or specify a repository path:

gitraffe /path/to/repo

Keyboard Shortcuts

• ↑/↓ or k/j - Scroll up/down
• PgUp/PgDn - Page up/down
• Home/End - Jump to top/bottom
• q or Esc or Ctrl+C - Quit

Dependencies

• Bubble Tea - TUI framework
• Lip Gloss - Style definitions for nice terminal layouts
• go-git - Pure Go implementation of Git
• Bubbles - TUI components for Bubble Tea

Release

git tag v0.1.0
git push --tags

License

MIT License - see LICENSE file for details.