not-manu

not-manu / filemention.nvim

Public

@ file mentions in neovim. for prompts, notes, commits.

ai blink-cmp claude claude-code completion-source
31
0
100% credibility
Found May 18, 2026 at 35 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Lua
AI Summary

filemention.nvim is a plugin for the Neovim text editor that makes it easy to reference files within your documents. When you're writing notes, documentation, or commit messages, you simply type @ and the plugin shows you every file in your project. You pick the one you need, and it gets inserted as a clean file reference. It works seamlessly with popular completion tools and only activates when you're writing text content, so it stays out of your way while coding.

How It Works

1
✍️ Writing documentation or notes

You're working on a project and need to reference other files in your writing.

2
💡 You discover file mentions

You learn about a simple trick: type @ and your editor shows all project files.

3
🔑 The magic moment

You type @ and instantly see a searchable list of every file in your project.

4
Choose your style
📄
Simple mention

Get a clean @path/to/file reference that stays out of your way.

🔗
Markdown link

Type [@](path) to create a proper clickable markdown link.

5
👆 Select and insert

You fuzzy-search through your files and pick the exact one you need.

✨ Perfect file reference

The file reference appears exactly where you wanted it, and you keep writing.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 35 to 31 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is filemention.nvim?

This is a Neovim plugin written in Lua that lets you mention files in your documents using @ syntax. Type @ in insert mode while writing markdown, notes, or commit messages, and you get a fuzzy file picker that inserts a reference to the selected file. It works with both nvim-cmp and blink.cmp completion engines. The plugin respects gitignore by default and searches from your git root, so you only see relevant project files.

Why is it gaining traction?

The [@ trick is clever -- type [@ instead of @ and you get a proper markdown link like [@README.md](README.md). This makes it useful beyond just note-taking: developers can reference files in documentation, commit messages, and prompts for AI tools. The plugin has no external dependencies beyond your completion engine, and it gracefully falls back through fd, ripgrep, and pure Lua file discovery. Smart defaults mean it only activates in text-like buffers, so it doesn't interfere with code editing.

Who should use this?

Writers documenting codebases who want to link to actual files. Developers drafting commit messages or changelogs who need to reference specific files. Anyone using Neovim as a notes app and wanting to embed file references. The plugin pairs well with GitHub Copilot workflows where @ mentions can guide AI context.

Verdict

At 31 stars, this is a young project with a 1.0% credibility score -- the API could shift and test coverage is minimal. That said, the code is clean, the defaults are sensible, and it solves a real pain point for anyone living in Neovim. Worth a try if file mentions fit your workflow.

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.