Skip to content

A beautiful Cross-platform CLI for exploring git repos, built with Bun. gitp provides an intuitive way to explore commit history and file changes in any git repo.

License

Notifications You must be signed in to change notification settings

sbcinnovation/gitp

Repository files navigation

gitp: Pretty git exploration for the terminal

gitp = git print gipt example

A beautiful Cross-platform CLI for exploring git repos, built with Bun. gitp provides an intuitive way to explore commit history and file changes in any git.

Features

  • 🌿 Branch Navigation: Browse all local and remote branches
  • 🪟🔄 Dynamic Git Diff views: Readable giffs for the terminal
  • 📝 Commit History: View commit messages and details
  • 📁 File Explorer: See which files changed in each commit
  • 🎨 Beautiful UI: Rich terminal interface with colors and navigation
  • ⌨️ VIM-like Controls: Intuitive keyboard navigation
  • 🔍 Fuzzy Search: Be fast, lightning fast.
  • Fast: Built with Bun for optimal performance

Tech Stack

  • Bun - Fast JavaScript runtime
  • Ink - React for CLI apps
  • React - UI framework

Installation

macOS (Homebrew)

brew install sbcinnovation/tap/gitp

Windows (Scoop)

scoop bucket add sbcinnovation https://github.com/sbcinnovation/scoop-bucket
scoop install gitp

Linux

  • Homebrew on Linux:
brew install sbcinnovation/tap/gitp
  • Debian/Ubuntu (.deb):

Download the latest .deb from the Releases page, then:

sudo dpkg -i gitp_<version>_linux_amd64.deb   # or arm64
sudo apt-get -f install
  • RHEL/CentOS/Fedora (.rpm):

Download the latest .rpm from the Releases page, then:

sudo rpm -i gitp_<version>_linux_x86_64.rpm   # or aarch64

Install from source

  1. Clone the repository:
git clone <your-repo-url>
cd sbc-gitp
  1. Install dependencies:
make install
# or
bun install
  1. Make the script executable:
make setup

Usage

Quick Start

make start
# or
bun run start

Development Mode

make dev
# or
bun run dev

Build

make build

Clean

make clean

Navigation Flow

  1. Branches View: Select a git branch to explore
  2. Commits View: Browse commit history for the selected branch
  3. Files View: See which files changed in the selected commit
  4. File Content: View the actual file content at that commit

Contributing

We welcome pull requests. If you're passionate about lmux and want to help long-term, we're open to adding maintainers, feel free to open an issue to introduce yourself!

Requirements

  • Bun: Latest version (install from bun.sh)
  • Git: Must be in a git repository
  • Terminal: Supports colors and arrow keys

License

MIT

About

A beautiful Cross-platform CLI for exploring git repos, built with Bun. gitp provides an intuitive way to explore commit history and file changes in any git repo.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •