getreadystack/proto-wire-break-check repository overview

⁠Proto Wire Break Check

Names the .proto edits that keep compiling and quietly change what old gRPC readers see

⁠Run

docker run --rm -v "$PWD":/work getreadystack/proto-wire-break-check /work/file

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

⁠Free

• Open any .proto, run one command, and all 17 rules run on that file: every finding with its line number, what an old reader will do with that byte, and the edit that keeps the wire intact. The 27-line sample in the repo returns 18 findings, 10 of them errors; the clean sample returns 0. No key, no account - that is the whole job for one file.
• --rules lists every rule

⁠With a licence ($29 once)

• The full version sweeps every .proto in the workspace in one pass and writes PROTO-WIRE-AUDIT.md plus audit.json - one file you can commit, attach to a pull request, or fail a build on. $29 once, one licence key per person or team seat.

docker run --rm -e READYSTACK_LICENSE=<key> -v "$PWD":/work getreadystack/proto-wire-break-check --dir /work --ci

A contract backend engineer runs $60+/hour on the public marketplaces, and reviewing one service's schema history by hand is an afternoon of that.

⁠Use from an AI agent (MCP)

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

{ "mcpServers": { "proto-wire-break-check": { "command": "npx", "args": ["-y", "@readystack/proto-wire-break-check", "--mcp"] } } }

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

⁠Use in CI

- name: Proto Wire Break Check
  run: npx -y @readystack/proto-wire-break-check --dir . --ci

(container: docker run --rm -v "$PWD:/work" getreadystack/proto-wire-break-check --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⁠