Froggit

A modern, minimalist Git TUI

Designed for clarity, speed, and smooth integration with your terminal workflow.

Installation

Quick Install (Recommended)

Linux / macOS:

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

Windows (PowerShell):

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

Build from Source

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

Requirements

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

Feature Support

Git Operations

Feature	Status	Description
Stage all	🟢	Stage all changes
Branches	🟢	View and manage branches
Remotes	🟢	Manage remote repositories
Push	🟢	Push changes to remote
Fetch	🟢	Fetch from remote
Pull	🟢	Pull changes (when remote changes available)
Commit	🟢	Create commits
Discard changes	🟢	Discard uncommitted changes
Refresh	🟢	Refresh repository status
Advanced mode	🟢	Access to logs, merge, stash, rebase
Logs	🟢	View commit history
Merge	🟢	Merge branches
Stash	🟡	Stash changes
Rebase	🟢	Rebase branches

GitHub CLI Integration

Feature	Status	Description
Create repository	🟢	Create new GitHub repository
Clone repository	🟢	Clone from your GitHub repositories

🟢 Supported    🟡 In Development    🔴 Planned

GitHub CLI Integration

Froggit integrates seamlessly with GitHub CLI to enhance your workflow.

gh auth login

Once authenticated, Froggit will detect gh and enable features like cloning repositories directly from GitHub.

Key Shortcuts

File Management

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

Branch Operations

• b: View branches
• n: Create new branch
• d: Delete branch
• Enter: Switch branch

Advanced Mode

• A: Enter advanced mode
• M: Merge (in advanced mode)
• R: Rebase (in advanced mode)

Global

• q, Ctrl+C: Quit
• Esc: Go back
• ?: Show help

For a complete list of shortcuts, see the keyboard shortcuts documentation.

Documentation

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

Related Tools

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

Learn More About Git

• Git Handbook – A practical, visual Git reference

Contributing

We welcome contributions! Please see our Contributing Guidelines for details on how to get started.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Vicente Roa
GitHub: @thewizardshell

---