vimtagger.nvim

A simple, project-local file tagging plugin for Neovim with Telescope integration.

• Tag files with arbitrary labels.
• Search files by tags using Telescope.
• Tags are stored per project.
• Fast lookups using an inverted index.
• Includes tools to inspect and validate the tag database.
• A Pane to check tags, rename and files associated with tags

• Neovim >= 0.10
• telescope.nvim

Using lazy.nvim

{
    "Rimkomatic/vimtagger.nvim",
    dependencies = {
        "nvim-telescope/telescope.nvim",
    },
    config = function()
        require("vimtagger").setup()
    end,
}

Initialize vimtagger for your project.

:VimtaggerInit

Add a tag to the current file.

:TagAdd backend

Add another tag.

:TagAdd api

Search files by tag.

:TagFindFiles

Open the panel to edit tags, files etc

:TagTogglePane

Default configuration:

require("vimtagger").setup({
    directory = vim.fn.stdpath("data") .. "/vimtagger",
})

Each project maintains its own independent tag database.

The database filename is derived from the SHA-256 hash of the project's root directory, allowing different projects to maintain separate tag collections without requiring configuration.

Internally, vimtagger maintains two structures:

• Forward Index

file
 ├── backend
 ├── api
 └── database

• Inverted Index

backend
 ├── main.go
 ├── server.go

api
 ├── server.go
 ├── routes.go

The inverted index enables fast tag-based lookups without scanning every file.

Tag databases are stored in

stdpath("data")/vimtagger/

Each project is represented by a single JSON file.

:VimtaggerInit

:TagAdd backend
:TagAdd api
:TagAdd database

:TagFindFiles
:TagTogglePane