Quickstart

Your first hullcheck

Three ways to run one. All return the same deterministic grade.

1. The web (no install)

Go to hullchecks.com, paste a live URL or drop a project zip, and read the grade. Nothing is stored — your upload is deleted right after the report.

2. The CLI (offline)

Scan a folder or a zip from your terminal. Your code never leaves the machine:

npx @hullchecks/cli .
# or a zip
npx @hullchecks/cli ./my-app.zip

Fail a CI build on criticals with --fail-on critical. Full reference on the CLI page.

3. Your AI editor

Wire the MCP server into Claude Code, Cursor, or Windsurf so issues are caught while you're still prompting. See MCP setup →.

Reading the grade

• Seaworthy (A/B) — no criticals; minor or no issues.
• Taking on water (C/D) — real issues to fix before you ship.
• Below the waterline (F) — at least one critical; one leaked key caps the score here however clean the rest is.

The score is deterministic — the same project always grades the same, and no language model touches the math.