Awesome

fzf-git.sh

bash and zsh key bindings for Git objects, powered by fzf.

Each binding will allow you to browse through Git objects of a certain type, and select the objects you want to paste to your command-line.

Installation

1. Install the latest version of fzf
   • (Optional) Install bat for syntax-highlighted file previews
2. Source fzf-git.sh file from your .bashrc or .zshrc

Usage

List of bindings

• <kbd>CTRL-G</kbd><kbd>CTRL-F</kbd> for Files
• <kbd>CTRL-G</kbd><kbd>CTRL-B</kbd> for Branches
• <kbd>CTRL-G</kbd><kbd>CTRL-T</kbd> for Tags
• <kbd>CTRL-G</kbd><kbd>CTRL-R</kbd> for Remotes
• <kbd>CTRL-G</kbd><kbd>CTRL-H</kbd> for commit Hashes
• <kbd>CTRL-G</kbd><kbd>CTRL-S</kbd> for Stashes
• <kbd>CTRL-G</kbd><kbd>CTRL-L</kbd> for reflogs
• <kbd>CTRL-G</kbd><kbd>CTRL-W</kbd> for Worktrees
• <kbd>CTRL-G</kbd><kbd>CTRL-E</kbd> for Each ref (git for-each-ref)

[!WARNING] You may have issues with these bindings in the following cases:

• <kbd>CTRL-G</kbd><kbd>CTRL-B</kbd> will not work if <kbd>CTRL-B</kbd> is used as the tmux prefix
• <kbd>CTRL-G</kbd><kbd>CTRL-S</kbd> will not work if flow control is enabled, <kbd>CTRL-S</kbd> will freeze the terminal instead
  • (stty -ixon will disable it)

To workaround the problems, you can use <kbd>CTRL-G</kbd><kbd>{key}</kbd> instead of <kbd>CTRL-G</kbd><kbd>CTRL-{KEY}</kbd>.

[!WARNING] If zsh's KEYTIMEOUT is too small (e.g. 1), you may not be able to hit two keys in time.

Inside fzf

• <kbd>TAB</kbd> or <kbd>SHIFT-TAB</kbd> to select multiple objects
• <kbd>CTRL-/</kbd> to change preview window layout
• <kbd>CTRL-O</kbd> to open the object in the web browser (in GitHub URL scheme)

Customization

# Redefine this function to change the options
_fzf_git_fzf() {
  fzf --height=50% --tmux 90%,70% \
    --layout=reverse --multi --min-height=20 --border \
    --border-label-pos=2 \
    --color='header:italic:underline,label:blue' \
    --preview-window='right,50%,border-left' \
    --bind='ctrl-/:change-preview-window(down,50%,border-top|hidden|)' "$@"
}

Defining shortcut commands

Each binding is backed by _fzf_git_* function so you can do something like this in your shell configuration file.

gco() {
  _fzf_git_each_ref --no-multi | xargs git checkout
}

gswt() {
  cd "$(_fzf_git_worktrees --no-multi)"
}

Environment Variables