Slop

Catch AI-generated code anti-patterns before they ship.

Install

npm install -g slopcheck

Or run locally:

npm install
node cli/index.js check ./src

Usage

# Scan a single file
slop check ./src/api/orders.js

# Scan a directory
slop check ./src

# Filter by severity
slop check ./src --severity high

# Save a markdown report
slop check ./src --output slop-report.md

# Raw JSON output (for CI/scripts)
slop check ./src --json

# List all patterns in the SlopIndex
slop patterns

Setup

Requires an ANTHROPIC_API_KEY environment variable.

export ANTHROPIC_API_KEY=your_key_here

Or add to a .env file (use dotenv or set in your shell profile).

The SlopIndex

The pattern library lives in /slop-index/patterns/. Each .md file is one anti-pattern with:

• What it looks like
• Why AI generates it
• How to catch it
• How to fix it

The library grows over time. Contributions welcome.

Exit Codes

• 0 — No high severity issues found
• 1 — One or more high severity issues found (useful for CI blocking)

Roadmap

• [ ] npm publish
• [ ] GitHub Action
• [ ] Pre-commit hook
• [ ] Pattern auto-discovery from repo mining
• [ ] Self-updating SlopIndex
• [ ] VS Code extension