Share a Snyk report

Snyk finds the advisory. The expensive part is what comes after: deciding whether the vulnerable path is reachable, whether the major-version bump is worth it this sprint, and who owns it. That decision is made once and lost immediately, because CI keeps the finding and throws away the reasoning.

snyk-to-html already renders a readable artifact. The missing piece is a place where the artifact and the reasoning live together.

Publish it

snyk test --json > snyk.json || true
npx snyk-to-html -i snyk.json -o snyk.html

curl -fsS -X PATCH \
  "https://commareports.com/api/v1/reports/$COMMA_REPORT_ID" \
  -H "Authorization: Bearer $COMMA_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --rawfile html snyk.html \
        --arg title "Snyk — api — $(date +%F)" \
        '{title: $title, html: $html}')"

|| true because snyk test exits non-zero when it finds something, which is the run you want published. One report id per project, PATCHed on every scan, gives you a stable URL and a revision history.

Free · no card

Turn your report into a link

Drop an HTML file or paste it. Teammates open one URL and comment on the exact chart or line.

Your file is read in this tab and nothing is uploaded until you publish. Creating an account is free, and reading a shared link never needs one.

What the URL changes

  • Advisories get owners and reasons. Highlight the finding, pin "transitive via foo@2, not reachable from our entrypoint, upgrade queued". See commenting on HTML.
  • Trend instead of snapshot. Revision diffs show what the dependency bump actually fixed.
  • Readable without a seat. Auditors, contractors and the security reviewer who does not use your CI can open the link.
  • Scheduled rescans. A routine re-runs the scan weekly so new advisories against unchanged code still surface.

Limits

  • HTML body: 5 MB. A monorepo scan with --all-projects can exceed it — publish per project.
  • Scripts run, sandboxed: allow-scripts, no allow-same-origin.
  • 60 requests/minute per token. Use a scoped token with reports:write only.

Try it

Comma is free — unlimited reports, unlimited commenters, unlimited revision history.

Publish a scan →

Related

Have an HTML report to share? Publish it free and send one link people can comment on.