2.12.2 • Public • Published


    Build Release RPC Release remote plugin Release coc extensions

    Support Support Language Language Lint with Styled with Tested with Powered by Powered by Powered by License Doc All contributors

    fzf-preview is a (Neo)vim plugin and coc extension written in TypeScript that provide powerful integration with fzf. It provides multiple presets for fzf and correspondingly powerful preview functionality. It also provides advanced interactive git integration.

    Since fzf-preview.vim implements RPC in the Vim script, it will work in both Vim and Neovim if you use the RPC release. It can also be installed as Remote Plugin and coc extensions. If you want to use the integration with coc, install coc extensions.

    Introductory Article (Japanese)

    This plugin can be easily extended in comparison to fzf.vim.

    e.g. Fugitive(launch git commands), bdelete(delete a selected buffer from the buffer list)



    1. Provides an excellent UI with floating windows by default
    2. Supports devicons and output highlighting by default
    3. Preview the selected item (with an arbitrary command)
    4. Fast file and buffer search by fuzzy matching
    5. Search all project files and history
    6. Search from file history files using oldfiles and mru
    7. Interactive git integration (with Fugitive or Gina)
    8. Jump lines from jumplist or changelist
    9. Interactive grep and preview from the current project
    10. Export the selected items to QuickFix.


    Open file and :bdelete


    Interactive git integration (Integrate with Fugitive or Gina)




    Export quickfix and refactor (with vim-qfreplace)



    Remote Plugin

    coc extensions




    When bat is installed you can highlight the preview and see it. Otherwise, head will be used


    Vim script RPC

    Use Dein, vim-plug or any Vim plugin manager of your choice.

    Install release/rpc branch.

    Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
    Plug 'yuki-yano/fzf-preview.vim', { 'branch': 'release/rpc' }


    call dein#add('junegunn/fzf', { 'build': './install --all', 'merged': 0 })
    call dein#add('yuki-yano/fzf-preview.vim', { 'rev': 'release/rpc' })

    Remote Plugin

    Install the npm package neovim to get the remote plugin working.

    $ npm install -g neovim

    Use Dein, vim-plug or any Vim plugin manager of your choice.

    Install release/remote branch and execute :UpdateRemotePlugins when after installed plugin.

    Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
    Plug 'yuki-yano/fzf-preview.vim', { 'branch': 'release/remote', 'do': ':UpdateRemotePlugins' }


    call dein#add('junegunn/fzf', { 'build': './install --all', 'merged': 0 })
    call dein#add('yuki-yano/fzf-preview.vim', { 'rev': 'release/remote' })

    coc extensions

    Install the fzf, coc.nvim and install coc-fzf-preview

    Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
    Plug 'neoclide/coc.nvim', { 'branch': 'release' }
    call dein#add('junegunn/fzf', { 'build': './install --all', 'merged': 0 })
    call dein#add('neoclide/coc.nvim', { 'rev': 'release', 'merged': 0 })


    :CocInstall coc-fzf-preview



    Vim script RPC, Remote Plugin, and coc extensions, in that order.

    " Select project files
    :CocCommand fzf-preview.ProjectFiles
    " Select file from git ls-files
    :CocCommand fzf-preview.GitFiles
    " Select file from directory files (default to current working directory) (Required [ripgrep](
    :FzfPreviewDirectoryFilesRpc {path or none}
    :FzfPreviewDirectoryFiles {path or none}
    :CocCommand fzf-preview.DirectoryFiles
    " Select file buffers. Used open-buffer processes.
    :CocCommand fzf-preview.Buffers
    " Select all buffers. Used open-bufnr processes
    :CocCommand fzf-preview.AllBuffers
    " Select project files from oldfiles
    :CocCommand fzf-preview.ProjectOldFiles
    " Select project mru (Most Recently Used) files
    :CocCommand fzf-preview.ProjectMruFiles
    " Select project mrw (Most Recently Written) files
    :CocCommand fzf-preview.ProjectMrwFiles
    " Grep project files from args word
    :FzfPreviewProjectGrepRpc {args}
    :FzfPreviewProjectGrep {args}
    :CocCommand fzf-preview.ProjectGrep {args}
    " Run FzfPreviewProjectGrep with the same arguments as before.
    :CocCommand fzf-preview.ProjectGrepRecall
    " Select tags from tags file (Required [universal-ctags](
    :CocCommand fzf-preview.Ctags
    " Select tags from current files (Required [universal-ctags](
    :CocCommand fzf-preview.BufferTags
    " Select files from oldfiles
    :CocCommand fzf-preview.OldFiles
    " Select mru (Most Recently Used) files
    :CocCommand fzf-preview.MruFiles
    " Select mrw (Most Recently Written) files
    :CocCommand fzf-preview.MrwFiles
    " Select line from QuickFix
    :CocCommand fzf-preview.QuickFix
    " Select line from LocationList
    :CocCommand fzf-preview.LocationList
    " Select line from current buffer (Required [bat](
    :CocCommand fzf-preview.Lines
    " Select line from loaded buffer
    :CocCommand fzf-preview.BufferLines
    " Select jumplist item
    :CocCommand fzf-preview.Jumps
    " Select changelist item
    :CocCommand fzf-preview.Changes
    " Select mark
    :CocCommand fzf-preview.Marks
    " Select files from selected resources (project, git, directory, buffer, project_old, project_mru, project_mrw, old, mru, mrw)
    :CocCommand fzf-preview.FromResources
    " Execute and edit command history
    :CocCommand fzf-preview.CommandPalette
    # Grep vim help
    :CocCommand fzf-preview.GrepHelp
    " Interactive git integration. (Required [Fugitive]( or [Gina](
    :CocCommand fzf-preview.GitActions
    " Select git status listed file. (Required [Fugitive]( or [Gina](
    :CocCommand fzf-preview.GitStatus
    " Select references from vim-lsp
    " Select diagnostics from vim-lsp
    " Select current file diagnostics from vim-lsp
    " Select definitions from vim-lsp
    " Select type definitions from vim-lsp
    " Select implementations from vim-lsp
    " Select tags from vista.vim (Required [vista.vim](
    :CocCommand fzf-preview.VistaCtags
    " Select current buffer tags from vista.vim (Required [vista.vim](
    :CocCommand fzf-preview.VistaBufferCtags
    " Select bookmarks (Required [vim-bookmarks](
    :CocCommand fzf-preview.Bookmarks
    " Select register history (Required [yankround.vim](
    :CocCommand fzf-preview.Yankround
    " Select memolist (Required [glidenote/memolist.vim](
    :CocCommand fzf-preview.MemoList
    " Grep memolist (Required [glidenote/memolist.vim](
    :CocCommand fzf-preview.MemoListGrep
    " Search TodoComments (Required  [folke/todo-comments.nvim](
    :CocCommand fzf-preview.TodoComments
    " Open the PR corresponding to the selected line (Required [GitHub cli](
    :CocCommand fzf-preview.BlamePR
    " Select references from coc.nvim (only coc extensions)
    :CocCommand fzf-preview.CocReferences
    " Select diagnostics from coc.nvim (only coc extensions)
    :CocCommand fzf-preview.CocDiagnostics
    " Select current file diagnostics from coc.nvim (only coc extensions)
    :CocCommand fzf-preview.CocCurrentDiagnostics
    " Select definitions from coc.nvim (only coc extensions)
    :CocCommand fzf-preview.CocDefinition
    " Select type definitions from coc.nvim (only coc extensions)
    :CocCommand fzf-preview.CocTypeDefinition
    " Select implementations from coc.nvim (only coc extensions)
    :CocCommand fzf-preview.CocImplementations
    " Select outline from coc.nvim (only coc extensions)
    :CocCommand fzf-preview.CocOutline

    Recommended mappings

    Vim script RPC

    nmap <Leader>f [fzf-p]
    xmap <Leader>f [fzf-p]
    nnoremap <silent> [fzf-p]p     :<C-u>FzfPreviewFromResourcesRpc project_mru git<CR>
    nnoremap <silent> [fzf-p]gs    :<C-u>FzfPreviewGitStatusRpc<CR>
    nnoremap <silent> [fzf-p]ga    :<C-u>FzfPreviewGitActionsRpc<CR>
    nnoremap <silent> [fzf-p]b     :<C-u>FzfPreviewBuffersRpc<CR>
    nnoremap <silent> [fzf-p]B     :<C-u>FzfPreviewAllBuffersRpc<CR>
    nnoremap <silent> [fzf-p]o     :<C-u>FzfPreviewFromResourcesRpc buffer project_mru<CR>
    nnoremap <silent> [fzf-p]<C-o> :<C-u>FzfPreviewJumpsRpc<CR>
    nnoremap <silent> [fzf-p]g;    :<C-u>FzfPreviewChangesRpc<CR>
    nnoremap <silent> [fzf-p]/     :<C-u>FzfPreviewLinesRpc --add-fzf-arg=--no-sort --add-fzf-arg=--query="'"<CR>
    nnoremap <silent> [fzf-p]*     :<C-u>FzfPreviewLinesRpc --add-fzf-arg=--no-sort --add-fzf-arg=--query="'<C-r>=expand('<cword>')<CR>"<CR>
    nnoremap          [fzf-p]gr    :<C-u>FzfPreviewProjectGrepRpc<Space>
    xnoremap          [fzf-p]gr    "sy:FzfPreviewProjectGrepRpc<Space>-F<Space>"<C-r>=substitute(substitute(@s, '\n', '', 'g'), '/', '\\/', 'g')<CR>"
    nnoremap <silent> [fzf-p]t     :<C-u>FzfPreviewBufferTagsRpc<CR>
    nnoremap <silent> [fzf-p]q     :<C-u>FzfPreviewQuickFixRpc<CR>
    nnoremap <silent> [fzf-p]l     :<C-u>FzfPreviewLocationListRpc<CR>

    Remote Plugin

    nmap <Leader>f [fzf-p]
    xmap <Leader>f [fzf-p]
    nnoremap <silent> [fzf-p]p     :<C-u>FzfPreviewFromResources project_mru git<CR>
    nnoremap <silent> [fzf-p]gs    :<C-u>FzfPreviewGitStatus<CR>
    nnoremap <silent> [fzf-p]ga    :<C-u>FzfPreviewGitActions<CR>
    nnoremap <silent> [fzf-p]b     :<C-u>FzfPreviewBuffers<CR>
    nnoremap <silent> [fzf-p]B     :<C-u>FzfPreviewAllBuffers<CR>
    nnoremap <silent> [fzf-p]o     :<C-u>FzfPreviewFromResources buffer project_mru<CR>
    nnoremap <silent> [fzf-p]<C-o> :<C-u>FzfPreviewJumps<CR>
    nnoremap <silent> [fzf-p]g;    :<C-u>FzfPreviewChanges<CR>
    nnoremap <silent> [fzf-p]/     :<C-u>FzfPreviewLines --add-fzf-arg=--no-sort --add-fzf-arg=--query="'"<CR>
    nnoremap <silent> [fzf-p]*     :<C-u>FzfPreviewLines --add-fzf-arg=--no-sort --add-fzf-arg=--query="'<C-r>=expand('<cword>')<CR>"<CR>
    nnoremap          [fzf-p]gr    :<C-u>FzfPreviewProjectGrep<Space>
    xnoremap          [fzf-p]gr    "sy:FzfPreviewProjectGrep<Space>-F<Space>"<C-r>=substitute(substitute(@s, '\n', '', 'g'), '/', '\\/', 'g')<CR>"
    nnoremap <silent> [fzf-p]t     :<C-u>FzfPreviewBufferTags<CR>
    nnoremap <silent> [fzf-p]q     :<C-u>FzfPreviewQuickFix<CR>
    nnoremap <silent> [fzf-p]l     :<C-u>FzfPreviewLocationList<CR>

    coc extensions

    nmap <Leader>f [fzf-p]
    xmap <Leader>f [fzf-p]
    nnoremap <silent> [fzf-p]p     :<C-u>CocCommand fzf-preview.FromResources project_mru git<CR>
    nnoremap <silent> [fzf-p]gs    :<C-u>CocCommand fzf-preview.GitStatus<CR>
    nnoremap <silent> [fzf-p]ga    :<C-u>CocCommand fzf-preview.GitActions<CR>
    nnoremap <silent> [fzf-p]b     :<C-u>CocCommand fzf-preview.Buffers<CR>
    nnoremap <silent> [fzf-p]B     :<C-u>CocCommand fzf-preview.AllBuffers<CR>
    nnoremap <silent> [fzf-p]o     :<C-u>CocCommand fzf-preview.FromResources buffer project_mru<CR>
    nnoremap <silent> [fzf-p]<C-o> :<C-u>CocCommand fzf-preview.Jumps<CR>
    nnoremap <silent> [fzf-p]g;    :<C-u>CocCommand fzf-preview.Changes<CR>
    nnoremap <silent> [fzf-p]/     :<C-u>CocCommand fzf-preview.Lines --add-fzf-arg=--no-sort --add-fzf-arg=--query="'"<CR>
    nnoremap <silent> [fzf-p]*     :<C-u>CocCommand fzf-preview.Lines --add-fzf-arg=--no-sort --add-fzf-arg=--query="'<C-r>=expand('<cword>')<CR>"<CR>
    nnoremap          [fzf-p]gr    :<C-u>CocCommand fzf-preview.ProjectGrep<Space>
    xnoremap          [fzf-p]gr    "sy:CocCommand   fzf-preview.ProjectGrep<Space>-F<Space>"<C-r>=substitute(substitute(@s, '\n', '', 'g'), '/', '\\/', 'g')<CR>"
    nnoremap <silent> [fzf-p]t     :<C-u>CocCommand fzf-preview.BufferTags<CR>
    nnoremap <silent> [fzf-p]q     :<C-u>CocCommand fzf-preview.QuickFix<CR>
    nnoremap <silent> [fzf-p]l     :<C-u>CocCommand fzf-preview.LocationList<CR>

    Base Fzf window Keymaps

    <C-g>, <Esc>
      Cancel fzf
      Open split
      Open vsplit
      Open tabedit
      Jump to buffer if already open. See :drop.
      If g:fzf_preview_buffers_jump is set to 1 then it will open the buffer in
      current window instead.
      Build QuickFix in open-file processes.
      Execute :bdelete! command from open-buffer and open-bufnr processes.
      Preview page down
      Preview page up
      Toggle display of preview screen


    Optional Configuration Tips

    • Increase the size of file history:
    " oldfiles uses viminfo, but the default setting is 100
    " Change the number by setting it in viminfo with a single quote.
    " Ref: viminfo-'
    set viminfo='1000
    • Set values for each variable. The default settings are as follows.
    " floating window size ratio
    let g:fzf_preview_floating_window_rate = 0.9
    " fzf window position settings
    let g:fzf_preview_direct_window_option = ''
    " fzf command default options
    let g:fzf_preview_default_fzf_options = { '--reverse': v:true, '--preview-window': 'wrap' }
    " Add fzf quit mapping
    let g:fzf_preview_quit_map = 1
    " jump to the buffers by default, when possible
    let g:fzf_preview_buffers_jump = 0
    " Commands used for fzf preview.
    " The file name selected by fzf becomes {}
    let g:fzf_preview_command = 'cat'                               " Not installed bat
    " let g:fzf_preview_command = 'bat --color=always --plain {-1}' " Installed bat
    " g:fzf_binary_preview_command is executed if this command succeeds, and g:fzf_preview_command is executed if it fails
    let g:fzf_preview_if_binary_command = '[[ "$(file --mime {})" =~ binary ]]'
    " Commands used for binary file
    let g:fzf_binary_preview_command = 'echo "{} is a binary file"'
    " Commands used to get the file list from project
    let g:fzf_preview_filelist_command = 'git ls-files --exclude-standard'               " Not Installed ripgrep
    " let g:fzf_preview_filelist_command = 'rg --files --hidden --follow --no-messages -g \!"* *"' " Installed ripgrep
    " Commands used to get the file list from git repository
    let g:fzf_preview_git_files_command = 'git ls-files --exclude-standard'
    " Commands used to get the file list from current directory
    let g:fzf_preview_directory_files_command = 'rg --files --hidden --follow --no-messages -g \!"* *"'
    " Commands used to get the git status file list
    let g:fzf_preview_git_status_command = 'git -c color.status=always status --short --untracked-files=all'
    " Commands used for git status preview.
    let g:fzf_preview_git_status_preview_command =  "[[ $(git diff --cached -- {-1}) != \"\" ]] && git diff --cached --color=always -- {-1} || " .
    \ "[[ $(git diff -- {-1}) != \"\" ]] && git diff --color=always -- {-1} || " .
    \ g:fzf_preview_command
    " Commands used for project grep
    let g:fzf_preview_grep_cmd = 'rg --line-number --no-heading --color=never --hidden'
    " MRU and MRW cache directory
    let g:fzf_preview_cache_directory = expand('~/.cache/vim/fzf_preview')
    " If this value is not 0, disable mru and mrw
    let g:fzf_preview_disable_mru = 0
    " Limit of the number of files to be saved by mru
    let g:fzf_preview_mru_limit = 1000
    " Commands used for current file lines
    let g:fzf_preview_lines_command = 'cat -n'                                " Not Installed bat
    " let g:fzf_preview_lines_command = 'bat --color=always --plain --number' " Installed bat
    " Commands used for preview of the grep result
    let g:fzf_preview_grep_preview_cmd = expand('<sfile>:h:h') . '/bin/preview_fzf_grep'
    " Cache directory for mru and mrw
    let g:fzf_preview_cache_directory = expand('~/.cache/vim/fzf_preview')
    " Keyboard shortcuts while fzf preview is active
    let g:fzf_preview_preview_key_bindings = ''
    " let g:fzf_preview_preview_key_bindings = 'ctrl-d:preview-page-down,ctrl-u:preview-page-up,?:toggle-preview'
    " Specify the color of fzf
    let g:fzf_preview_fzf_color_option = ''
    " Set the processes when selecting an element with fzf
    let g:fzf_preview_custom_processes = {}
    " For example, set split to ctrl-s
    " let g:fzf_preview_custom_processes['open-file'] = fzf_preview#remote#process#get_default_processes('open-file')
    " on coc extensions
    " let g:fzf_preview_custom_processes['open-file'] = fzf_preview#remote#process#get_default_processes('open-file', 'coc')
    " let g:fzf_preview_custom_processes['open-file']['ctrl-s'] = g:fzf_preview_custom_processes['open-file']['ctrl-x']
    " call remove(g:fzf_preview_custom_processes['open-file'], 'ctrl-x')
    " Use as fzf preview-window option
    let g:fzf_preview_fzf_preview_window_option = ''
    " let g:fzf_preview_fzf_preview_window_option = 'up:30%'
    " Use vim-devicons
    let g:fzf_preview_use_dev_icons = 0
    " Use fzf history option
    let g:fzf_preview_history_dir = false
    " let g:fzf_preview_history_dir = '~/.fzf'
    " devicons character width
    let g:fzf_preview_dev_icon_prefix_string_length = 3
    " Devicons can make fzf-preview slow when the number of results is high
    " By default icons are disable when number of results is higher that 5000
    let g:fzf_preview_dev_icons_limit = 5000
    " The theme used in the bat preview

    Command Options

    Commented-out lines are settings for the coc extension.

    " Set process when selecting element with fzf started by this command.
    " Value must be a global variable name.
    " Variable is dictionary and format is same as g:fzf_preview_custom_processes['open-file'].
    " Most commands are passed a file path to the process function.
    " FzfPreviewAllBuffers will be passed “buffer {bufnr}”
    " Value example: let g:foo_processes = {
    "                \ '':       'FzfPreviewOpenFileEnter',
    "                \ 'ctrl-x': get(function('s:foo_function'), 'name'),
    "                \ }
    " Set the arguments to be passed when executing fzf.
    " This value is added to the default options.
    " Value must be a string without spaces.
    " Example: Exclude filename with FzfPreviewProjectGrep
    nnoremap <Leader>g :<C-u>FzfPreviewProjectGrep --add-fzf-arg=--nth=3<Space>
    " nnoremap <Leader>g :<C-u>CocCommand fzf-preview.ProjectGrep --add-fzf-arg=--nth=3<Space>
    " Reuse the input that was last used to select the element with fzf.
    " Do not need to pass a value for this option.
    " Example: Reuse last query for project grep.
    nnoremap <Leader>G :<C-u>FzfPreviewProjectGrep . --resume<Space>
    " nnoremap <Leader>G :<C-u>CocCommand fzf-preview.ProjectGrep . --resume<Space>


    " Get the initial value of the open file processes
    " processes_name is 'open-file', 'open-buffer' and 'open-bufnr'.
    " plugin_type is 'remote', 'coc' or 'rpc'. Default value is 'remote'
    call fzf_preview#remote#process#get_default_processes({processes_name}, {plugin_type})

    Release note

    Changes history
    • 2021/12/05 version 2.12.0

      • Implement vim-lsp resources.
    • 2021/10/15 version 2.9.0

      • Implement coc outline resource.
    • 2021/09/10 version 2.7.0

      • Implement vim help resource.
    • 2021/09/08 version 2.6.0

      • Improve project files performance
    • 2021/06/06 version 2.5.0

      • Implement --experimental-fast option.
    • 2021/06/04 version 2.4.0

    • 2021/05/19 version 2.3.0

      • Implement fzf history option.
    • 2021/05/18 version 2.2.0

      • Implement grep recall.
    • 2021/01/16 version 2.0.7

      • Implement coc implementations resource.
    • 2021/01/16 version 2.0.6

    • 2021/01/10 version 2.0.0

      • Release of stable version.
      • Change release from github actions.
      • Update latest npm packages.
    • 2021/01/06 version 0.6.0

      • Update coc.nvim package version to 0.0.80.
    • 2020/12/31 version 0.5.0

      • Implement Vim script RPC
        • Only need Vim and Node
      • Breaking change: The release branch of the Remote Plugin has been changed to release/remote.
    • 2020/11/08 version 0.4.27

      • Add g:fzf_preview_direct_window_option option.
    • 2020/11/07 version 0.4.26

      • Change buffer sort with mru order.
      • Add mru and mrw limit settings.
      • Improve grep preview highlight.
    • 2020/10/30 version 0.4.24

      • Improved grep etc previews to scroll to the top of the file.
    • 2020/10/4 version 0.4.20

      • Implement CommandPalette resource.
    • 2020/10/4 version 0.4.17

      • Implement CocTypeDefinitions resource.
    • 2020/07/30 version 0.4.7

      • Implement git reflog integration.
    • 2020/07/30 version 0.4.6

      • Implement git stash integration.
      • Implement rename git branch.
    • 2020/07/27 version 0.4.1

      • Implement create git branch.
    • 2020/07/27 version 0.4.0

      • Implement interactive git integration. (:FzfPreviewGitActions and :CocCommand fzf-preview.GitActions)
    • 2020/07/24 version 0.3.2

      • Remove g:fzf_preview_filelist_postprocess_command and to colorize the fzf window by default
    • 2020/07/24 version 0.2.1

      • Change g:fzf_preview_default_fzf_options and g:fzf_preview_fzf_preview_window_option default value.
      • Fix export quickfix bug in grep.
    • 2020/07/23 version 0.2.0

      • Improving the internal data structure.
      • Remove FzfPreviewProjectCommandGrep command. (Changes to the data structure have made implementation difficult)
      • Some bug fixes.


    • How to use fish user?
      • Set the set shell and $SHELL.
    set shell=/bin/zsh
    let $SHELL = "/bin/zsh"
    • Use true color preview in Neovim
      • Set the preview command to COLORTERM=truecolor
    augroup fzf_preview
      autocmd User fzf_preview#rpc#initialized call s:fzf_preview_settings() " fzf_preview#remote#initialized or fzf_preview#coc#initialized
    augroup END
    function! s:fzf_preview_settings() abort
      let g:fzf_preview_command = 'COLORTERM=truecolor ' . g:fzf_preview_command
      let g:fzf_preview_grep_preview_cmd = 'COLORTERM=truecolor ' . g:fzf_preview_grep_preview_cmd
    • FzfPreviewVistaBufferCtags does not work
      • Vista must be initialized. Run the Vista command once or write the following settings.
    autocmd VimEnter * call vista#RunForNearestMethodOrFunction()


    The MIT License (MIT)



    npm i coc-fzf-preview

    DownloadsWeekly Downloads






    Unpacked Size

    493 kB

    Total Files


    Last publish


    • yuki-yano