Review-comments.nvim: Do code review in Neovim – pass review comments to agents

The review-comments.nvim plugin, published by developer narqo, lets Neovim users draft code review comments on individual lines or ranges and store each one as a Markdown file with JSON frontmatter in a .review-comments directory at the workspace root. The plugin, installable via vim.pack on Neovim 0.12 and newer, exposes :AddComment, :ViewComment, and :RefreshComment commands and ships an agent skill at .agents/skills/review-comment-inbox/SKILL.md that lets coding agents inspect, address, test, and remove resolved comments. Its configuration options, including output_dir and keymap, are labeled experimental.

Draft code review comments from inside Neovim https://neovim.io/ . Comment a line or a range of lines in any file in the workspace: Colour scheme: classylight https://github.com/narqo/classylight.vim You can add a comment from the diff too: Each comment is stored in a separate Markdown file with JSON frontmatter in the .review-comments directory inside the workspace root. You can then point your coding agent to the stored comments, and ask it to address and to resolve each of them. Using vim.pack https://neovim.io/doc/user/pack/ vim.pack on Neovim 0.12 and newer : -- Add this to init.lua vim.pack.add { 'https://github.com/narqo/review-comments.nvim' } 1. Select lines with visual line mode, for example Vjj . 2. Run :AddComment while the selection is active. 3. Enter the comment in the floating editor. 4. Run :write or :w to save and close. 5. The saved comment appears as virtual text after the source line and is written under <git-root /.review-comments/ . To use with jj diffedit https://jj-vcs.github.io/jj/latest/cli-reference/ jj-diffedit , the plugin needs the logical file path from nvim.difftool to resolve the Git root from Neovim's working directory: js merge-tools.nvim edit-args = "--cmd", "let g:review comments root = trim system 'jj root' ", "--cmd", "packadd nvim.difftool", "-d", "$left", "$right", g:review comments root must be an absolute path to the workspace root. It overrides automatic root detection. Run jj diffedit and add comments in a any normal buffer: jj diffedit --tool=nvim The plugin loads comments when entering a source buffer. Each preview shows up to 40 characters from the first non-empty line. Place the cursor inside a commented range and run: :ViewComment Reload comments created, changed, or removed externally with: :RefreshComment The agent skill at .agents/skills/review-comment-inbox/SKILL.md allows coding agents to inspect, address, test, and remove resolved comments. In pi https://pi.dev/ , start it explicitly with: /skill:review-comment-inbox Caution Exposed configuration options are experimental. js require "review-comments" .setup { output dir = ".review-comments", keymap = "<leader ac", } From this plugin directory, open a file from any Git repository: nvim --cmd "set runtimepath+=$PWD" /path/to/git-repo/source.go make test