https://github.com/wsdjeg/mru.nvim
MRU(Most Recently Used) Files for Neovim
https://github.com/wsdjeg/mru.nvim
mru neovim-plugin
Last synced: 25 days ago
JSON representation
MRU(Most Recently Used) Files for Neovim
- Host: GitHub
- URL: https://github.com/wsdjeg/mru.nvim
- Owner: wsdjeg
- License: gpl-3.0
- Created: 2025-02-20T01:36:51.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2025-04-13T11:42:39.000Z (about 1 month ago)
- Last Synced: 2025-04-13T12:35:53.891Z (about 1 month ago)
- Topics: mru, neovim-plugin
- Language: Lua
- Homepage:
- Size: 32.2 KB
- Stars: 5
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# mru.nvim
A lightweight Neovim plugin to manage and display your Most Recently Used (MRU) files.
* [Overview](#overview)
* [Features](#features)
* [Installation](#installation)
* [Usage](#usage)
* [Configuration](#configuration)
* [Contributing](#contributing)
* [Self-Promotion](#self-promotion)
* [License](#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.
## Installation
Use your preferred Neovim plugin manager to install mru.nvim.
with [nvim-plug](https://github.com/wsdjeg/nvim-plug)
```lua
require('plug').add({
{ 'wsdjeg/mru.nvim' }
})
```
Then use `:PlugInstall mru.nvim` to install this plugin.
## Usage
Add custom keybindings to your init.lua for faster access. Example:
```lua
vim.api.nvim_set_keymap('n', 'm', ':Telesscope mru', { noremap = true, silent = true })
```
Now, pressing `m` (e.g., `\m` by default) will open the MRU list.
## Configuration
Customize mru.nvim by adding the following to your Neovim config:
```lua
require('mru').setup({
enable_cache = true,
mru_cache_file = vim.fn.stdpath('data') .. '/nvim-mru.json',
events = { 'BufEnter', 'BufWritePost' }, -- events to update mru file list
ignore_path_regexs = { '/.git/' },
enable_logger = true, -- require wsdjeg/logger.nvim
})
```
## 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.
## Self-Promotion
Like this plugin? Star the repository on
GitHub.
Love this plugin? Follow [me](https://wsdjeg.net/) on
[GitHub](https://github.com/wsdjeg) and
[Twitter](http://twitter.com/wsdtty).
## License
This project is licensed under the GPL-3.0 License.