A modern, intuitive Terminal User Interface (TUI) for Git
Simplify your Git workflow with visual feedback and keyboard-driven controls
Installation • Features • Usage • Shortcuts • Documentation
# Install
git clone https://github.com/thewizardshell/froggit.git
cd froggit
go build
# Run
froggit-
📁 Visual File Management
- Stage/unstage files with visual feedback
- Bulk actions for multiple files
- Real-time status updates
-
🌿 Branch Operations
- Create and switch branches
- Delete branches safely
- Visual branch selection
-
🔄 Git Operations
- Commit changes with message preview
- Push/pull with progress indicators
- Remote repository management
qorCtrl+C- QuitEsc- Go back/cancel?- Show help
↑/↓- Navigate filesSpace- Stage/unstage filea- Stage all filesc- Commit staged filesx- Discard changes
b- Enter branch viewn- Create new branchd- Delete branchEnter- Switch to branch
p- Push changesf- Fetch updatesl- Pull changesr- Refresh status
Detailed documentation is available in the docs/ directory:
- Architecture Overview
- Development Guide
- Contributing Guidelines
- Git Commands Reference
- Keyboard Shortcuts
- Go - Performance and cross-platform support
- Bubbletea - Terminal UI framework
- Lipgloss - Style definitions
MIT License - see LICENSE for details
Vicente Roa (@thewizardshell)
While Froggit is designed to be a minimal and beginner-friendly Git TUI, there are several excellent tools out there that offer more advanced features or different workflows. Depending on your needs, you might want to explore them as well:
- LazyGit: A powerful and widely-used Git TUI, great for intermediate and advanced users: https://github.com/jesseduffield/lazygit.
- GitKraken: A GUI Git client with a rich graphical interface: https://www.gitkraken.com/.
- tig : Text-mode interface for Git, useful for browsing history and commits: https://github.com/jonas/tig.
- Magit: An interface to Git for Emacs users, highly customizable and powerful: https://github.com/magit/magit.
Froggit aims to serve as a stepping stone — especially for those new to Git or who prefer simplicity over complexity. Feel free to try different tools and find what works best for your workflow!