A modern, minimalist Git TUI
Designed for clarity, speed, and smooth integration with your terminal workflow.

Installation • Features • GitHub CLI Integration • Shortcuts • Documentation

• Git installed and accessible in your terminal
• Go 1.20+ (only required if building from source)
• A terminal with Nerd Fonts support for best UI experience
• GitHub CLI (gh) – optional, for GitHub integration

curl -s https://raw.githubusercontent.com/thewizardshell/froggit/master/scripts/install.sh | bash

iwr https://raw.githubusercontent.com/thewizardshell/froggit/master/scripts/install.ps1 -UseBasicParsing | iex

git clone https://github.com/thewizardshell/froggit.git
cd froggit
go mod tidy
go build
./froggit

• Visual Git Interface

  • Stage, unstage, discard changes
  • View logs and diffs interactively

• Branch Management

  • Create, switch, and delete branches

• GitHub CLI Integration

  • Clone and explore repositories using gh (if installed)

• Other Tools

  • Stash support
  • Rebase and merge support
  • Commit previews with feedback

Froggit optionally integrates with GitHub CLI for features like cloning and listing repositories.

To set it up:

gh auth login

This will walk you through authenticating with GitHub.

Once logged in, Froggit will detect gh and unlock additional options for cloning and working with your GitHub repositories.

(See full list in keyboard-shortcuts.md)

• ↑ / ↓: Navigate files
• Space: Stage/unstage
• a: Stage all
• x: Discard changes
• c: Commit

• b: Open branch view
• n: New branch
• d: Delete branch
• Enter: Switch

• q, Ctrl+C: Quit
• Esc: Back
• ?: Help

• Installation Guide
• Architecture Overview
• Development Guide
• Contributing
• Keyboard Shortcuts

• Git Handbook – A clear and practical guide to mastering Git concepts.

• LazyGit – Git TUI for power users
• tig – Terminal Git history browser
• Magit – Git for Emacs

Vicente Roa GitHub: @thewizardshell