explaingit

not-manu/filemention.nvim

58Lua

TLDR

This is a small plugin for Neovim, the keyboard-driven text editor that descends from Vim.

Mindmap

A visual breakdown will appear here once this repo is fully enriched.

In plain English

This is a small plugin for Neovim, the keyboard-driven text editor that descends from Vim. Its job is narrow: when you are typing in insert mode and press the at sign, it pops up a fuzzy file picker. You pick a file from your project, and the plugin inserts a path reference like @path/to/file into your text. The README frames this as a native way to mention files inside prompts, notes, and git commit messages, similar to how chat tools let you reference files with the at sign. The author lists three target uses: writing prompts for AI coding tools, taking notes, and writing commit messages. The completion source plugs into either of the two main Neovim completion engines, nvim-cmp or blink.cmp. Installation uses lazy.nvim, a popular package manager for Neovim, with a one-line entry. By default the plugin only activates in markdown, text, and gitcommit files, which keeps it from popping up while you write real code. You can override this with a filetypes setting if you want it everywhere. Configuration options are listed in the README. You can change the trigger character from at sign to something else, choose whether the root is the git repo or the current working directory, respect or ignore gitignore rules, include hidden files, switch the inserted format between a bare path and a markdown link, and cap the number of items shown. A bracket-at trick is documented: typing left bracket then at sign inserts a proper markdown link like [@README.md](README.md), which is nicer when you are writing prose. For file discovery the plugin uses fd if available, then rg, then a pure Lua fallback using vim.fs.dir. There is optional integration with fff.nvim, a separate Neovim file picker that adds frecency ranking, typo resistance, and recents on top. If fff is not installed the plugin silently falls back to the other finders. The project has no dependencies beyond your completion engine and is released under the MIT license.

Open on GitHub → Explain another repo

Generated 2026-05-21 · Model: sonnet-4-6 · Verify against the repo before relying on details.