aislop

Catch the slop AI coding agents leave in your code.

The patterns Claude Code, Cursor, Codex, and OpenCode leave behind: narrative comments above self-explanatory code, swallowed exceptions, hidden fallbacks, as any casts, hallucinated imports, duplicated helpers, dead code, todo stubs, oversized functions. Tests pass. Lint passes. The code rots anyway.

aislop catches them. 50+ rules across 12 language targets (TypeScript, JavaScript, Expo / React Native, Python, Go, Rust, Ruby, PHP, Java, Scala (beta), C#, C/C++). Scores every change 0–100. Sub-second. Deterministic: no LLM in the runtime path, same code in, same score out. MIT-licensed, free CLI.

Quick start

1. Scan. Get your score in seconds. No install needed, works on any project.

npx aislop@latest scan

2. Install the hook so your coding agent fixes slop before it lands, on every edit. The hook calls aislop directly, so install the CLI first.

npm install -g aislop && aislop hook install

Also available on npm, Yarn, Bun, Homebrew, and PyPI:

npm install -g aislop                # npm
yarn dlx aislop scan                 # Yarn (no install)
bunx aislop scan                     # Bun (no install)
bun add -g aislop                    # Bun
brew install scanaislop/tap/aislop   # Homebrew
pipx install aislop                  # Python

See Installation for every option.

Language support

aislop supports TypeScript, JavaScript, Expo / React Native, Python, Go, Rust, Ruby, PHP, Java, Scala (beta), C#, and C/C++.

Scala support (beta): Initial support is available, with coverage and accuracy still being refined. Indentation-based Scala 3 catch clauses are supported. Broader Scala 3 syntax coverage and real-world scalafmt integration remain ongoing work.

Coverage includes formatting, linting, complexity, AI-slop detection, and security checks. Some checks use optional system tools; see Installation and the rules reference for details.

aislop agent                 # repair with your coding agent (Codex/Claude/OpenCode)
aislop fix                   # auto-fix the mechanical issues
aislop fix -f                # aggressive fixes (deps, unused files)
aislop ci                    # CI mode (JSON + gate)
aislop hook install --claude # per-edit hook

Public badge: Show your score on your README

[![aislop](https://badges.scanaislop.com/score/<owner>/<repo>.svg)](https://scanaislop.com)

Run npx aislop@latest badge to auto-generate. Free at scanaislop.com.

See it in action

Scan

---

Installation

The same CLI is published to npm, Homebrew, and PyPI. Pick whichever fits your stack.

Node / npm

# Run without installing
npx aislop@latest scan
bunx aislop@latest scan   # Bun

# npm
npm install --save-dev aislop

# yarn
yarn add --dev aislop

# pnpm
pnpm add -D aislop

# bun
bun add -d aislop

# Global
npm install -g aislop

Also available as @scanaislop/aislop on GitHub Packages.

Package installation does not run dependency lifecycle scripts. After installing, run aislop-tools once if you want bundled Ruff and golangci-lint coverage; the core scanner works without it.

For Java, run aislop-tools --java to download pinned, checksum-verified google-java-format, PMD, and Checkstyle distributions. Keep JDK 21 or newer on PATH. Existing executable system installations take precedence; the bundled tools run directly through Java without shell wrappers. Java formatting still requires a build-file opt-in, and Checkstyle uses your project's configuration.

Homebrew (macOS / Linux)

brew install scanaislop/tap/aislop

Homebrew installs Node.js as a dependency if it isn't already present. Details: homebrew-tap.

Python / pipx

pipx install aislop

pipx keeps aislop in its own isolated environment. Needs Node.js on PATH. Details: PyPI package.

Full reference for every channel, optional bundled tooling, and external tools: docs/installation.md.

---

Usage

Examples below use the installed aislop binary. For a one-off latest run, prefix the command with npx aislop@latest, for example npx aislop@latest scan.

Command reference

aislop --help              # clean overview
aislop commands            # every public command and major flag
aislop <command> --help    # detailed help for one command
aislop version             # installed version
aislop -V                  # installed version
aislop update              # current and latest npm versions

This is the beginning of the README. Read the rest at the original. Read the full README ↗