getreadystack/payroll-deduction-code-audit repository overview

⁠Payroll Deduction Code Audit 2026

Twelve rules over the deduction-code map, before the January 31 W-2 filing date

⁠Run

docker run --rm -v "$PWD":/work getreadystack/payroll-deduction-code-audit /work/file

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

⁠Free

• Every deduction code in the open map is audited against twelve rules and each broken line is named with its line number.
• --rules lists every rule

⁠With a licence ($29 once)

• Audits every deduction map in the workspace at once and writes a dated exposure report you keep as the payroll audit trail.

docker run --rm -e READYSTACK_LICENSE=<key> -v "$PWD":/work getreadystack/payroll-deduction-code-audit --dir /work --ci

Hand-checking one deduction map against the IRS Box 12 letter list is about half a day of a payroll analyst's time, every plan year

⁠Use from an AI agent (MCP)

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

{ "mcpServers": { "payroll-deduction-code-audit": { "command": "npx", "args": ["-y", "@readystack/payroll-deduction-code-audit", "--mcp"] } } }

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

⁠Use in CI

- name: Payroll Deduction Code Audit 2026
  run: npx -y @readystack/payroll-deduction-code-audit --dir . --ci

(container: docker run --rm -v "$PWD:/work" getreadystack/payroll-deduction-code-audit --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⁠