wfxr.forgit/README.md
2018-05-01 00:31:52 +08:00

2.4 KiB

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.

Commands

ga

Interactive git add selector

screenshot

Keybind Action
<Tab> Mark/Unmark(and move down)
<C-r> Reverse selection
<Enter> Confirm and quit
<C-j/n><C-k/p> Selection down/up
<?> Toggle preview window
<A-w> Toggle preview wrap
<A-j><A-k> Preview down/up

glo

Interactive git log browser

screenshot

Keybind Action
<Enter> Fullscreen preview
<C-j/n><C-k/p> Selection down/up
<?> Toggle preview window
<A-w> Toggle preview wrap
<A-j><A-k> Preview down/up

gd

Interactive git diff browser

Keybind Action
<Enter> Fullscreen preview
<C-j/n><C-k/p> Selection down/up
<?> Toggle preview window
<A-w> Toggle preview wrap
<A-j><A-k> Preview down/up

gi

Interactive .gitignore generator

screenshot

Custom aliases

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

Tips

  • Hit q to Quit from full screen preview any time.
  • Install diff-so-fancy to have better diff output.
  • Call gi with arguments to get wanted .gitignore contents directly(eg, gi c++).

License

The MIT License (MIT)

Copyright (c) 2018 Wenxuan Zhang