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/new/set/retire/reinstate/move/list/waive/renew/unwaive, :RulesVault, and waivers are real and tested. Pin a commit if you depend on this.
category
Debug & inspect
neovim
0.11+
repo
github.com/WKDSteve/rules.nvim
commits
208
help
:help rules

install

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

also as

  • native app: rules-desktop — A local web UI and desktop app for the rule set of rules.nvim

docs/

git log

  1. test mcp: scripts/mcp.lua as a real stdio process, driven by the lib.nvim MCP client
  2. feat mcp: read-only MCP server over rules-export/1
  3. test sheets: answer a question only once the focus is in its dialog
  4. test sheets: the flags the checklist lines name for list, check, gate and set
  5. test sheets: the :Rules and :RulesVault items of the bindings checklist
  6. docs regenerate the connection pictures (optional loads through probe/safe/package.loaded)
  7. fix ops: set takes surplus blank lines only in front of the closing divider
  8. fix ops: set writes one blank line between the text and the divider
  9. docs graphs: connections through optional loaders, programs, HTTP and files
  10. docs readme: connections to the other repos of the workshop, as a picture and a list
  11. ci regenerate the workflow, the ci-verified lookup fails closed (pipefail)
  12. test pass $RULES_UPDATE_GOLDEN to the spec child, name the golden update run

keys

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