WP Plugin Review Gate

Runs the same checker as our npm package on a Node.js runtime that pip installs for you (nodejs-wheel-binaries) - no system Node.js needed. Your files are checked locally.

The readme.txt and plugin-header lines that send a wordpress.org submission back, found before you submit

Install

wp-plugin-review-gate file

Node 18+. The same 21 rules as the VS Code extension, from a terminal or CI.

Free

• Checks the readme.txt or main plugin PHP file you have open against 21 rules and prints every blocker with its line number and the exact replacement line. On the sample readme.txt shipped with it, 6 blockers: Stable tag: trunk, no Requires PHP, Tested up to: 6.8.2 carrying a patch number, Tested up to 6.8 older than Requires at least 6.9, a short description of 179 characters against the 150-character cut, and a missing License URI.
• --rules lists every rule

With a licence ($29 once)

• Sweeps the whole plugin folder in one pass - readme.txt read against the plugin header, Stable tag against Version across files - and exports a dated submission report you keep. $29 once, one licence key per person or team seat.

wp-plugin-review-gate --dir ./templates --report html --out report.html

A freelance WordPress developer bills $30 to $90 an hour; a pre-submission read is an hour or two.

Use from an AI agent (MCP)

Claude Code · Cursor · Windsurf · any MCP client - add to your MCP config:

{ "mcpServers": { "wp-plugin-review-gate": { "command": "wp-plugin-review-gate", "args": ["--mcp"] } } }

Tools: check_text and check_file (free) · check_dir (licence). The agent gets every finding with the line number.

Use in CI

- name: WP Plugin Review Gate
  run: pip install rulestamp-wp-plugin-review-gate && wp-plugin-review-gate --dir . --ci

The folder sweep, reports and CI mode need one licence — one payment, no subscription. Set READYSTACK_LICENSE=<key> or run --license <key> once.

Get a licence

Install (PyPI)

pip install rulestamp-wp-plugin-review-gate
wp-plugin-review-gate --help