NORMAL ~/wkd/p/rules :set skin=modern utf-8

rules.nvim

A rule/checklist engine for Neovim. rules.nvim reads a set of rules you point it at, runs whichever of them can be checked mechanically against a repo, and reports the rest as a worklist — it never pretends to give an automatic verdict on a rule that actually needs human or agent judgment.

status
alpha — Alpha — small, working surface. The engine, the four check types, :Rules check/gate/show/stats, and waivers are real and tested. Pin a commit if you depend on this.
category
Debug & inspect
neovim
0.10+
repo
github.com/StefanBartl/rules.nvim
commits
51
help
:help rules

install

{
  "StefanBartl/rules.nvim",
  opts = {},
}

docs/

git log

  1. fix parser,runner: bound ids and agent hints, ask the trust policy only for predicates
  2. feat parser: keep text/title/section, validate agent, evaluate blocks in an empty environment (L10 P0)
  3. feat notify: move rules.nvim onto lib.nvim.notify.popup
  4. docs the agent concept is no longer linked, it lives in the author's notes
  5. docs link back to the wkd family site
  6. ci bump leafo/gh-actions-lua and gh-actions-luarocks off Node 20
  7. ci bump JohnnyMorganz/stylua-action to v5 (Node-20 deprecation)
  8. ci bump the failure-log upload to actions/upload-artifact@v7 (Node 24)
  9. ci add job timeouts, failure log artifacts, swap/shada-free nvim runs, pinned deps
  10. docs agent: parser keeps section, plan batches per scope with family scopes
  11. docs readme: link the agent-run manual rules plan
  12. docs plan for agent-run manual rules (docs/AGENT.md)

keys

j / k
next / previous line
gg / G
first / last line
⏎
open the line under the cursor
/
search the plugins
:
command line — Tab completes
:help x
vimdoc of a plugin (:e x = plugin page)
:ls · :log · :stack
plugin list · activity stream · dependency graph
:colo x
colorscheme
:set skin=
modern | tui
?
this help
esc
close