FZF :heart: MRU

Vim plugin that allows using awesome CtrlP MRU plugin with even more amazing fzf

I love FZF fuzzy search algorithm and CtrlP Mru tracking - I'm using it often to jump between two files (yes, I'm aware of <c-^>). The way how fzf-vim's :History works was not the best solution for me that's why I decided to create this plugin. It requires fzf.

Instalation

Using vim-plug:

Plug 'junegunn/fzf'

Plug 'pbogut/fzf-mru.vim'

Using Vundle:

Plugin 'junegunn/fzf'

Plugin 'pbogut/fzf-mru.vim'

Basic Usage

• You can run :FZFMru, :FZFMru [search-query] or :FZFMru [fzf-command-options].
• For example: :FZFMru --prompt "Sup? " -q "notmuch" or :FZFMru readme
• You can also map it to a shortcut with map <leader>p :FZFMru<cr>.
• Set let g:fzf_mru_relative = 1 to only list files within current directory.
• Set let g:fzf_mru_store_relative_dirs = ['/path/to/code'] to store files as relative paths, as opposed to as absolute ones. FZF-MRU will use the elements in this list as patterns to match the path against to see if it qualifies. This is useful if you have multiple copies of a repository on your computer that you switch between, and want to keep your MRU cache consistent between them.
• Set let g:fzf_mru_no_sort = 1 to prevent fzf from sorting list while typing, it will keep list sorted by recency.
• Set let g:fzf_mru_exclude_current_file = 0 to include the current file in the list since it's excluded by default.

FZF Options/Preview

You could pass FZF options and/or enable the file preview like this:

command! -bang -nargs=? FZFMru call fzf_mru#actions#mru(<q-args>,
    \{
        \'window': {'width': 0.9, 'height': 0.8},
        \'options': [
            \'--preview', 'cat {}',
            \'--preview-window', 'up:60%',
            \'--bind', 'ctrl-_:toggle-preview'
        \]
    \}
\)

nnoremap <Leader>fm :FZFMru<CR>

If bat is installed, which is the recommended previewer, you could replace the cat line in the command above:

            \'--preview', 'bat --style=numbers --color=always {}',

Telescope integration

Because why not?

Set up telescope extension

Add following to your init file to load the extension:

require('telescope').load_extension('fzf_mru')

Telescope usage:

• :Telescope fzf_mru - Display MRU list as it would be display with :FZFMru
• :Telescope fzf_mru current_path - List MRU files that are within current path (ignores g:fzf_mru_relative option).
• :Telescope fzf_mru all - List all MRU files (ignores g:fzf_mru_relative option).

Todo

• [x] ~~Move CtrlP MRU functionality to the plugin itself~~
• [x] ~~Make fzf.vim optional dependency~~
• [ ] Add Vim help

Credits

99% of MRU engine has been taken from CtrlP.

Contribution

Always welcome.

License

MIT License; The software is provided "as is", without warranty of any kind.