npm Trusted Publish Lint

Runs the same checker as our npm package on a Node.js runtime that pip installs for you (nodejs-wheel-binaries) - no system Node.js needed. Your files are checked locally.

Finds the credential in your release workflow that expires before your next release

Install

npm-trusted-publish-lint file

Node 18+. The same 15 rules as the VS Code extension, from a terminal or CI.

Free

• Open a workflow, .npmrc or package.json and get every npm publish credential, OIDC and provenance gap named on its own line by all 15 rules - no key, no account
• --rules lists every rule

With a licence ($29 once)

• Sweep every workflow in the repository in one pass and export the finished audit as a dated Markdown or CSV file you keep and hand to a reviewer

npm-trusted-publish-lint --dir ./templates --report html --out report.html

A freelance DevOps engineer is a median $60/hour on Upwork (typical range $40-$100); reading one release workflow and rewriting it for OIDC is most of an hour

Use from an AI agent (MCP)

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

{ "mcpServers": { "npm-trusted-publish-lint": { "command": "npm-trusted-publish-lint", "args": ["--mcp"] } } }

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

Use in CI

- name: npm Trusted Publish Lint
  run: pip install rulestamp-npm-trusted-publish-lint && npm-trusted-publish-lint --dir . --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

Install (PyPI)

pip install rulestamp-npm-trusted-publish-lint
npm-trusted-publish-lint --help