mru.nvim

A lightweight Neovim plugin to manage and display your Most Recently Used (MRU) files.

• Overview
• Features
• Installation
• Usage
• Configuration
• Contributing
• Credits
• Self-Promotion
• License

Overview

mru.nvim keeps track of the files you’ve recently opened in Neovim and provides quick access to them via telescope extension.

Features

• Unified file path format.
• Ignore path via regex.
• Lightweight and no dependencies.
• Support nvim-web-devicons

Installation

Use your preferred Neovim plugin manager to install mru.nvim.

Using nvim-plug

require('plug').add({
    { 'wsdjeg/mru.nvim' }
})

Then use :PlugInstall mru.nvim to install this plugin.

Usage

This plugin provides a :Mru command, which will list mru files in quickfix windows.

Users also can use fuzzy finder plugin. mru.nvim provides telescope extension and picker.nvim extension.

Add custom keybindings to your init.lua for faster access. Example:

vim.api.nvim_set_keymap('n', '<leader>m', ':Picker mru<CR>', { noremap = true, silent = true })

or

vim.api.nvim_set_keymap('n', '<leader>m', ':Telesscope mru<CR>', { noremap = true, silent = true })

Now, pressing <leader>m (e.g., \m by default) will open the MRU list.

Remove files from mru.

require('mru').remove(regex)

Configuration

Customize mru.nvim by adding the following to your Neovim config:

require('mru').setup({
  enable_cache = true,
  mru_cache_file = vim.fn.stdpath('data') .. '/nvim-mru.json',
  ignore_path_regexs = { '/.git/' },
  enable_logger = true, -- require wsdjeg/logger.nvim
  -- sort file by last modified time or last enter time
  -- `lastmod`, `lastread`, `frecency`
  -- or `lastenter`, default is `lastenter`
  sort_by = 'lastenter',
})

Contributing

Contributions are welcome! Feel free to:

• Fork this repository.
• Create a feature branch (git checkout -b feature/awesome-idea).
• Commit your changes (git commit -m "Add awesome idea").
• Push to the branch (git push origin feature/awesome-idea).
• Open a Pull Request.

Credits

• Shougo/neomru.vim

Self-Promotion

Like this plugin? Star the repository on GitHub.

Love this plugin? Follow me on GitHub.

License

This project is licensed under the GPL-3.0 License.