getreadystack/wp-plugin-review-gate repository overview

⁠WP Plugin Review Gate

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

⁠Run

docker run --rm -v "$PWD":/work getreadystack/wp-plugin-review-gate /work/file

The same 21 rules as the VS Code extension, in a container. Mount a folder on /work.

⁠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.

docker run --rm -e READYSTACK_LICENSE=<key> -v "$PWD":/work getreadystack/wp-plugin-review-gate --dir /work --ci

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": "npx", "args": ["-y", "@readystack/wp-plugin-review-gate", "--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: npx -y @readystack/wp-plugin-review-gate --dir . --ci

(container: docker run --rm -v "$PWD:/work" getreadystack/wp-plugin-review-gate --dir /work --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⁠