getreadystack/soup-list-lint repository overview

⁠SOUP List Lint (IEC 62304)

Reads your SOUP register the way an auditor does: 16 rules over clauses 8.1.2, 5.3.3, 5.3.4, 4.3 and 7.1.3.

⁠Run

docker run --rm -v "$PWD":/work getreadystack/soup-list-lint /work/file

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

⁠Free

• Lint one SOUP list, completely: every missing manufacturer, unpinned version, unclassified item and undated anomaly-list evaluation, each on its own line with the clause that asks for it.
• --rules lists every rule

⁠With a licence ($29 once)

• Scan every SOUP list in the workspace at once and export a dated evidence record (Markdown + CSV) to file with the technical documentation.

docker run --rm -e READYSTACK_LICENSE=<key> -v "$PWD":/work getreadystack/soup-list-lint --dir /work --ci

A regulatory consultant reviewing SOUP documentation bills $150-$250 an hour; a 30-item register is a morning of that, at every version bump.

⁠Use from an AI agent (MCP)

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

{ "mcpServers": { "soup-list-lint": { "command": "npx", "args": ["-y", "@readystack/soup-list-lint", "--mcp"] } } }

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

⁠Use in CI

- name: SOUP List Lint (IEC 62304)
  run: npx -y @readystack/soup-list-lint --dir . --ci

(container: docker run --rm -v "$PWD:/work" getreadystack/soup-list-lint --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⁠