fzf.vim

A set of fzf-based Vim commands.

Rationale

fzf in itself is not a Vim plugin, and the official repository only provides the basic wrapper function for Vim and it's up to the users to write their own Vim commands with it. However, I've learned that many users of fzf are not familiar with Vimscript and are looking for the "default" implementation of the features they can find in the alternative Vim plugins.

This repository is a bundle of fzf-based commands extracted from my .vimrc to address such needs. The commands are opinionated and not designed to be extremely flexible or configurable, and they are not guaranteed to be backward-compatible.

Installation

Using vim-plug:

Plug 'junegunn/fzf', { 'dir': '~/.fzf', 'do': 'yes \| ./install' }
Plug 'junegunn/fzf.vim'

List of commands

Command	List
Files [PATH]	Files (similar to :FZF)
Buffers	Open buffers
Colors	Color schemes
Ag [PATTERN]	ag search result (CTRL-A to select all, CTRL-D to deselect all)
Lines	Lines in loaded buffers
Tags	Tags in the project (ctags -R)
BTags	Tags in the current buffer
Locate PATTERN	locate command output
History	v:oldfiles and open buffers
Snippets	Snippets (UltiSnips)
Commands	User-defined commands

• All commands except Colors support CTRL-T / CTRL-X / CTRL-V key bindings to open in a new tab, a new split, or in a new vertical split.
• Bang-versions of the commands (e.g. Ag!) will open fzf in fullscreen

Customization

" This is the default extra key bindings
let g:fzf_action = {
  \ 'ctrl-t': 'tab split',
  \ 'ctrl-x': 'split',
  \ 'ctrl-v': 'vsplit' }

Fuzzy completion helper

fzf#complete is a helper function for creating custom fuzzy completion using fzf. If the first parameter is a command string or a Vim list, it will be used as the source.

" Replace the default dictionary completion with fzf-based fuzzy completion
inoremap <expr> <c-x><c-k> fzf#complete('cat /usr/share/dict/words')

For advanced uses, you can pass an options dictionary to the function. The set of options is pretty much identical to that for fzf#run only with the following exceptions:

• reducer (funcref)
  • Reducer transforms the output lines of fzf into a single string value
• prefix (string; default: \k*$)
  • Regular expression pattern to extract the completion prefix
• Both source and options can be given as funcrefs that take the completion prefix as the argument and return the final value
• sink or sink* are not allowed

function! s:first_line_in_uppercase(lines)
  return toupper(a:lines[0])
endfunction

inoremap <expr> <c-x><c-k> fzf#complete({
  \ 'source':  'cat /usr/share/dict/words',
  \ 'reducer': function('<sid>first_line_in_uppercase'),
  \ 'options': '--no-multi --reverse --margin 15%,0',
  \ 'left':    20})

License

MIT