plumber

let plumber do the job

Try a sample:

Inspection Categories

Deterministic checks across five core engineering disciplines.

leaks_and_secrets.log

CRITICAL

Scans for leaked API keys, tokens, and committed credentials.

  • OpenAI, Anthropic, AWS, Stripe keys
  • Plaintext passwords and database strings
  • Real production secrets in committed .env files

clogs_and_stubs.diff

HIGH

Finds AI agent diff elisions and silent failure blocks.

  • // ... existing code ... truncation tells
  • Silent error swallowing (except: pass, catch {})
  • Unimplemented stub functions & robotic step comments

ai_slop_tells.css

MEDIUM

Flags the aesthetic defaults generated by frontier models.

  • Purple-to-pink gradient defaults (from-purple-600)
  • Heavy neon blur glow box-shadows
  • Chatbot conversational residue (“As an AI model...”)

pipes_and_deps.json

HIGH

Detects hallucinated libraries and broken links.

  • Hallucinated package imports not in registry
  • Undeclared dependencies missing from manifest
  • Dead links using href="#" or javascript:void(0)

joints_and_ally.html

MEDIUM

Enforces semantic HTML and reliable test verification.

  • Clickable <div> elements without keyboard roles
  • Focus outlines stripped with outline: none
  • Empty unit tests containing zero assertions

run plumber everywhere

Integrate directly into your terminal, Claude Code, or Cursor workflow.

Inspect local directories or public repositories directly from your terminal (zero install):

npx plumber-linter scan .                      # inspect current repo
npx plumber-linter scan owner/repo             # stream and inspect GitHub repo
npx plumber-linter scan . --fail-on high       # enforce quality threshold

add the plumber badge

Party Parrot Badge

Display your repository health grade in your project README.

Plumber Badge Preview pallets/flask 

          

          
The badge renders clean SVG and refreshes at the edge.