sloplint

An open-source linter that detects AI-generated placeholder code, incomplete implementations, and lazy patterns commonly produced by AI coding assistants.

Why sloplint?

AI coding assistants often generate "slop":

• Incomplete implementations with TODO comments.
• Placeholder code like // ... rest of the code.
• Apologetic comments admitting shortcuts.
• Stub functions that throw NotImplementedError.
• Ellipsis comments indicating omitted code.

sloplint scans your codebase to flag these patterns before they reach production.

Features

• 12+ Detection Categories: From simple TODOs to complex AI-specific phrases.
• Fast Scanning: Built on fast-glob for high performance.
• Auto-Fix: Automatically remove safe debug statements like console.log("test").
• CI/CD Ready: Supports SARIF and JUnit XML for GitHub Actions and other CI tools.
• Intelligent Caching: Only scans modified files for lightning-fast subsequent runs.
• Ignore Logic: Supports // slop-ignore-next-line and // slop-ignore-file.

Installation

npm install -g sloplint

Or use without installing:

npx sloplint .

Usage

# Scan current directory
sloplint .

# Scan specific directory with JSON output
sloplint src/ --format json

# Enable auto-fixing
sloplint src/ --fix

# Enable caching
sloplint . --cache

Configuration

Create a .sloprc.json file in your project root:

{
  "rules": {
    "todo-comments": "error",
    "debug-statements": "warning",
    "ai-specific": "error"
  },
  "customPatterns": [
    {
      "name": "internal-todo",
      "pattern": "MYCOMPANY-TODO",
      "severity": "error",
      "message": "Found company-specific TODO"
    }
  ]
}

Rules

| Rule | Description | Default | |------|-------------|---------| | todo-comments | Detects TODO, FIXME, HACK, XXX | error | | placeholder-comments | Detects ellipsis like ... rest of code | error | | apologetic-comments | Detects "sorry, this is a hack" etc. | warning | | stub-functions | Detects empty or throwing stubs | error | | ai-specific | Detects AI instructional phrases | error | | suspicious-returns | Detects placeholder returns like return null | warning | | empty-catch | Detects swallowed errors | warning | | debug-statements | Detects console.log markers | error | | hardcoded-values | Detects placeholder API keys/secrets | warning | | incomplete-logic | Detects TODOs in switch/else blocks | warning | | fake-data | Detects "John Doe" style mock data | warning | | repetitive-placeholders| Detects "Item 1, Item 2..." patterns | warning |

Contributing

We welcome contributions! Please see our CONTRIBUTING.md for guidelines.

License

MIT © RezaLabs