bash, zsh, and fish key bindings for Git objects, powered by fzf
1.2k
Stars
94
Forks
14
Open issues
22
Contributors
AI Analysis
fzf-git.sh provides fuzzy-finding key bindings for Git objects (branches, commits, tags, files, etc.) in bash, zsh, and fish shells, powered by fzf. It is a specialized developer tool for users who work heavily in the terminal and want rapid Git object navigation without typing. Best suited for shell power users and developers who already use fzf; not a general-purpose Git client for casual users.
Inferred from signals mentioned in the README (tests, CI, type safety) — not a review of the actual code.
AI's overall editorial judgment — not an average of the bars above, can weigh other factors too.
Lightweight Git fuzzy finder bindings for shell power users seeking faster object selection
fzf-git.sh provides shell key bindings (CTRL-G combinations) for interactive browsing and selection of Git objects—branches, commits, files, tags, remotes, stashes, reflogs, worktrees—using fzf. Built by the creator of fzf itself, it targets developers already using fzf who want tighter Git integration without a full UI layer. Adoption appears concentrated among terminal-centric workflows; explicit production usage metrics are not publicly documented.
Created August 2022 by junegunn (Junegunn Choi, fzf's original author), fzf-git.sh emerged as a focused companion tool to fzf. It reflects the philosophy of composable Unix tools rather than monolithic Git clients. The project has maintained steady, low-velocity updates since creation.
Growth has been modest and stable: 1,154 stars over ~4 years, 93 forks, averaging ~3 stars/week recently. No spike events visible in metadata. The project appears to have found a sustainable niche audience rather than pursuing viral adoption. It benefits from fzf's established user base but does not attempt to replace dedicated Git UIs. Growth trajectory suggests word-of-mouth adoption among shell enthusiasts rather than active marketing.
Adoption not verified. No case studies, corporate usage, or production scale metrics mentioned in README or repository description. The tool's utility suggests it is likely used by individual developers and teams with shell-centric workflows, but concrete evidence is absent. Comparison to lazygit (79K stars) and forgit (5K stars) suggests fzf-git.sh occupies a smaller niche—possibly favored by those preferring lightweight, non-GUI solutions and already invested in fzf.
Likely a collection of bash/zsh/fish functions wrapping git CLI commands and piping output to fzf for interactive selection. Based on README, appears stateless—no persistent cache or state management. Customizable via shell function override (`_fzf_git_fzf`) and environment variables. README indicates support for optional syntax highlighting via bat.
Not documented in README. No mention of test suite, CI/CD, or test status in metadata available.
Last push 2026-06-16 (15 days before evaluation date), indicating active maintenance. MIT license. Metadata shows consistent activity pattern without long gaps. No major releases or version tags visible in provided metadata. Maintenance appears reactive to bugs/PRs rather than feature-driven; this is appropriate for a stable, narrow-scope tool.
ADOPT IF: you actively use fzf, prefer shell-native tools over dedicated UIs, work frequently with Git objects via command-line, and value minimal dependencies and fast startup. AVOID IF: you need visual Git history browsing, work in teams expecting uniform tooling, or prefer GUI/TUI clients with mouse support. MONITOR IF: you're evaluating whether fzf-based Git workflows scale to team environments or whether shell-centric approaches remain viable as IDEs consolidate Git features.
Independent dimensions
Mainstream potential
3/10
Technical importance
6/10
Adoption evidence
3/10
- Limited adoption makes community support sparse; edge cases may go unaddressed or require self-contribution.
- Tightly coupled to fzf; fzf changes or deprecations could break functionality, though author affiliation reduces this risk.
- Keyboard binding conflicts (CTRL-G, CTRL-B, CTRL-S) documented as problematic in tmux and with flow control; workarounds exist but add friction.
- Shell-only; no GUI fallback for non-terminal environments; not suitable for developers primarily using IDEs.
- Maintenance appears reactive; no public roadmap, and feature requests may be evaluated against scope rather than urgency.
fzf-git.sh will likely remain a stable, niche tool for terminal-first developers. Adoption may grow modestly within the fzf user base but is unlikely to reach mainstream (broader than shell enthusiasts). It serves a permanent, defensible niche rather than being a stepping stone to broader Git tooling.
Newsletter
Get analyses like this every Monday
Free weekly digest of the most interesting open-source discoveries.
Languages
Information
- Language
- Shell
- License
- MIT
- Last updated
- 4d ago
- Created
- 48mo ago
- Analyzed with
- anthropic/claude-haiku-4-5
Stars over time
Contributors over time
Top 100 contributors only — repos with more will plateau at 100.
Open issues
Ctrl-G Ctrl-H does not open the commit hash selector, but other commands work
Space is inserted on abort
"open in browser" is maybe a bit too generic
Allow customization of fish key bindings
All keybinds delete last word of selected text in Bash
Top contributors
Recent releases
No releases published yet.
Similar repos
| Repository | Stars | Week Δ | Language | Score | Updated |
|---|---|---|---|---|---|
|
junegunn/fzf-git.sh
this
|
1.2k | +7 | Shell | 8/10 | 4d ago |
 bigH/git-fuzzy
|
2.4k | — | Shell | 7/10 | 3w ago |
|
junegunn/fzf
|
81.6k | — | Go | 10/10 | 4d ago |
 PatrickF1/fzf.fish
|
2.7k | — | Shell | 8/10 | 3w ago |
 wfxr/forgit
|
5k | — | Shell | 8/10 | 15h ago |
 magicmonty/bash-git-prompt
|
6.9k | — | Shell | 7/10 | 3mo ago |
Full-featured Git UI with dedicated TUI. Larger ecosystem (79K stars), broader appeal. fzf-git.sh is lighter, keyboard-centric, shell-native; lazygit offers richer visual feedback and mouse support. Different philosophies: composition vs. integration.
Also shell-based Git fuzzy finder (5K stars), similar scope. fzf-git.sh authored by fzf's creator; likely benefits from tighter integration and trust within fzf community. Direct competitor but adoption suggests both coexist for different preferences.
Prompt enhancement tool (6.9K stars) focused on status display, not object selection. Complementary rather than competing; different problem domain.
fzf-git.sh reduces cognitive load and keystroke count for common workflows (checkout branch, view commit, etc.). Targets efficiency gain, not capability expansion.
fzf-git.sh is not a competitor but a plugin/extension leveraging fzf's ecosystem. Entirely dependent on fzf.
