whatisgithub

What is filemention.nvim?

not-manu/filemention.nvim — explained in plain English

Analysis updated 2026-06-24

58LuaAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

A small Neovim plugin that pops up a fuzzy file picker when you type the at sign in insert mode and inserts a path reference, aimed at prompts, notes, and commit messages.

Mindmap

mindmap
  root((filemention))
    Inputs
      At sign trigger
      Project files
      Filetype filter
    Outputs
      Path reference
      Markdown link
      Completion items
    Use Cases
      Reference files in AI prompts
      Link notes to source files
      Mention files in commit messages
    Tech Stack
      Lua
      Neovim
      nvim-cmp
      blink.cmp
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Reference repo files inside a prompt you are drafting for an AI coding tool

USE CASE 2

Insert markdown links to project files while writing notes in Neovim

USE CASE 3

Mention specific files in a git commit message body without leaving the editor

USE CASE 4

Pair with fff.nvim to get frecency-ranked file mentions across a large repo

What is it built with?

LuaNeovimnvim-cmpblink.cmp

How does it compare?

not-manu/filemention.nvimbjarneo/omarchy-ochre-themefullband7/openwrt-theme-foxhound
Stars581616
LanguageLuaLuaLua
Setup difficultyeasyeasymoderate
Complexity2/51/53/5
Audiencedevelopergeneralops devops

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires one of nvim-cmp or blink.cmp already configured, and only activates in markdown, text, and gitcommit by default.

MIT, use and modify freely as long as the copyright notice is kept.

So what is it?

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.

Copy-paste prompts

Prompt 1
Add filemention.nvim to my lazy.nvim config with nvim-cmp and enable it only for markdown, gitcommit, and text files
Prompt 2
Change the filemention.nvim trigger from at sign to backtick and have it respect gitignore
Prompt 3
Use the bracket-at trick in filemention.nvim to insert proper markdown links to files when I write blog posts
Prompt 4
Set up filemention.nvim with blink.cmp instead of nvim-cmp and have it use fd for file discovery
Prompt 5
Extend filemention.nvim so the inserted format includes the file's git relative path inside a custom snippet

Frequently asked questions

What is filemention.nvim?

A small Neovim plugin that pops up a fuzzy file picker when you type the at sign in insert mode and inserts a path reference, aimed at prompts, notes, and commit messages.

What language is filemention.nvim written in?

Mainly Lua. The stack also includes Lua, Neovim, nvim-cmp.

What license does filemention.nvim use?

MIT, use and modify freely as long as the copyright notice is kept.

How hard is filemention.nvim to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is filemention.nvim for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.