getreadystack/hex-image-audit repository overview

⁠Intel HEX & S-record Image Audit

Recomputes every record checksum in a .hex or .s19 firmware image and names the bad records, the overlaps, the gaps and the missing EOF by line number, before the image reaches the programmer.

⁠Run

docker run --rm -v "$PWD":/work getreadystack/hex-image-audit /work/file

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

⁠Free

• Audit one .hex or .s19 image end to end in the editor or in the browser: all 16 checks, every record checksum recomputed, every address range mapped, every defect named with its line number.
• --rules lists every rule

⁠With a licence ($29 once)

• Audit the whole build output folder in one pass and export a dated Markdown image-audit report you keep - the artefact a release record or a CRA technical-documentation file needs.

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

Embedded firmware contract work is commonly billed at $90-$150 an hour; one hour of it costs more than this licence.

⁠Use from an AI agent (MCP)

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

{ "mcpServers": { "hex-image-audit": { "command": "npx", "args": ["-y", "@readystack/hex-image-audit", "--mcp"] } } }

Tools: check_text and check_file (free) · check_dir (licence; the full sweep is free for 7 days). The agent gets every finding with the line number.

⁠Use in CI

- name: Intel HEX & S-record Image Audit
  run: npx -y @readystack/hex-image-audit --dir . --ci

(container: docker run --rm -v "$PWD:/work" getreadystack/hex-image-audit --dir /work --ci)

Try the full run free for 7 days — no key needed. Then one licence, 7-day refund, no questions. Set READYSTACK_LICENSE=<key> or run --license <key> once.

Get a licence⁠