git-fuzzy
An interactive CLI for git that uses fzf for fuzzy searching and visual selection of branches, commits, diffs, and status.
What is git-fuzzy?
git-fuzzy is a command-line tool that provides an interactive interface to git using fzf for fuzzy searching. It allows developers to visually manage git operations like staging changes, browsing commit logs, viewing diffs, and handling branches through a menu-driven system. It solves the problem of memorizing complex git commands by offering an intuitive, searchable interface.
Developers and DevOps engineers who frequently use git in the terminal and want a faster, more visual way to manage repositories without leaving the CLI.
It combines the power of git with the fuzzy-finding capabilities of fzf, offering a seamless, keyboard-driven workflow that reduces manual command typing and enhances productivity for complex git operations.
Overview
interactive git with the help of fzf
Use Cases
Best For
- Visually staging and unstaging changes in large codebases
- Searching through git history with instant diff previews
- Managing multiple branches with fuzzy search and quick checkout
- Exploring diffs with highlighted search terms and interactive navigation
- Handling git stashes and reflogs through a searchable interface
- Integrating GitHub pull request workflows directly in the terminal
Not Ideal For
- CI/CD pipelines requiring non-interactive, headless git operations
- Users who prefer vanilla git with minimal third-party dependencies
- Teams with strict git command standardization and no tolerance for UI-driven workflows
Pros & Cons
Pros
Provides a visual interface for staging, unstaging, and discarding changes using cursor selection, as shown in the status.gif demo.
Leverages fzf to search commit logs, diffs, branches, and stashes with instant previews, reducing the need to memorize complex git commands.
Configurable via environment variables for diff tools, keybindings, layouts, and git command defaults, detailed in the Customizing section.
Enables searching within diffs with highlighted results and interactive navigation, demonstrated in the diff.gif.
Cons
Requires fzf version 0.21.0 or higher installed and configured, adding an external dependency that may not be available in all environments.
Setup involves shell scripting, environment variables, and bc calculations, which can be error-prone, as warned in the FOOTGUN section about branch defaults.
The README admits that the UI flashes due to fzf's alternate screen switching, which can disrupt the user experience.
Frequently Asked Questions
Related Projects
lazygitsimple terminal UI for git commands
diveA tool for exploring each layer in a docker image
zoxideA smarter cd command. Supports all major shells.
zsh-autosuggestionsFish-like autosuggestions for zsh
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.