forgit

forgit is a utility tool for git taking advantage of fuzzy finder fzf.

Installation

Make sure you have fzf installed.

for zplug (Recommend)

zplug 'wfxr/forgit', defer:1

for zgen

zgen load wfxr/forgit

for antigen

antigen bundle wfxr/forgit

Manually

Clone this repo somewhere and source the forgit.plugin.zsh at ~/.zshrc or source forgit.plugin.sh in ~/.bashrc.

Commands

ga

Interactive git add selector

glo

Interactive git log browser

gd

Interactive git diff browser

gcf

Interactive git checkout <file> selector

gclean

Interactive git clean selector

gi

Interactive .gitignore generator

Default keybinds

Keybind	Action
<Enter>	Confirm
<Tab>	Toggle mark
<C-k/p>	Selection up
<C-j/n>	Selection down
<A-k/p>	Preview up
<A-j/n>	Preview down
<A-w>	Toggle preview wrap
<?>	Toggle preview window
<C-r>	Toggle selection
<C-s>	Toggle sort

Custom options

You can change the default aliases by defining these variables below.

# Define them before sourcing the plugin if you don't use any plugin manager.
forgit_log=glo
forgit_diff=gd
forgit_add=ga
forgit_ignore=gi
forgit_restore=gcf
forgit_clean=gclean

You can add custom fzf options for forgit, including keybinds, layout, etc. (No need to repeat the options already defined in FZF_DEFAULT_OPTS)

FORGIT_FZF_DEFAULT_OPTS="
--exact
--border
--cycle
--reverse
--height '80%'
"

Tips

• Hit q to Quit from full screen preview any time.
• Install diff-so-fancy to have better diff output.
• Commands like glo, gd, gcf and gclean accept path arguments to restrain the items listed in fzf(eg, glo main.go test.go, gclean output/).
• Call gi with arguments to get wanted .gitignore contents directly(eg, gi c++).

License

The MIT License (MIT)

Copyright (c) 2018 Wenxuan Zhang