aislop for Homebrew

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 10 language targets (TypeScript, JavaScript, Expo / React Native, Python, Go, Rust, Ruby, PHP, 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.

This tap is the Homebrew distribution of aislop. The CLI is identical across every channel. Prefer npm or Python tooling? See other ways to install.

Install

brew install scanaislop/tap/aislop

That one-liner taps the repo and installs in a single step. The longer form is equivalent:

brew tap scanaislop/tap
brew install aislop

Then scan any project:

aislop scan

First run

From the root of a repo:

aislop scan

You get a single 0–100 score and a list of findings. Common next steps:

aislop fix                   # auto-fix safe issues
aislop fix -f                # aggressive fixes (deps, unused files)
aislop ci                    # CI-friendly JSON output and exit code
aislop hook install --claude # install a per-edit agent hook
aislop rules                 # see every rule
aislop doctor                # check local tool availability

What gets installed

This tap exposes two commands:

• aislop — the CLI
• aislop-mcp — the MCP server, for tools that speak Model Context Protocol

Homebrew installs Node.js as a runtime dependency if it is not already present, so there is nothing else to set up. Run aislop doctor to confirm every engine can run on your machine.

Hand off to your agent

When auto-fix can't solve an issue, pass the remaining findings to your coding agent with full context:

aislop fix --claude          # Claude Code
aislop fix --codex           # Codex CLI
aislop fix --cursor          # Cursor (copies to clipboard)
aislop fix --gemini          # Gemini CLI
aislop fix --prompt          # print an agent-agnostic prompt

Install a hook so feedback flows back after every edit:

aislop hook install --claude # Claude Code
aislop hook install          # pick agents interactively

MCP server

Expose aislop as MCP tools (aislop_scan, aislop_fix, aislop_why, aislop_baseline) for Claude Desktop, Cursor, or Codex:

{
  "mcpServers": {
    "aislop": {
      "command": "aislop-mcp"
    }
  }
}

CI

aislop scan --staged              # staged files before commit
aislop ci                         # JSON output, exits 1 if score < threshold
aislop scan --sarif > aislop.sarif # SARIF 2.1.0 for GitHub code scanning

Set a minimum score in .aislop/config.yml:

ci:
  failBelow: 70

More: CI/CD docs.

Configure

Tune rules, severities, and excluded paths in .aislop/config.yml:

exclude:
  - "**/*.test.ts"
  - src/generated
rules:
  ai-slop/narrative-comment: warning   # error | warning | off

Run aislop init to scaffold one. Full reference: configuration docs.

Upgrade

brew update
brew upgrade aislop

Check whether a newer release is available:

aislop upgrade

Examples

aislop scan --changes         # only changed files from HEAD
aislop scan --staged          # staged files before commit
aislop scan --sarif > aislop.sarif  # SARIF for GitHub code scanning
aislop badge                  # generate a public score badge

Troubleshooting

If Homebrew says /opt/homebrew/bin/aislop already exists, another install already owns the command. Choose one install source, or let Homebrew overwrite the existing link:

brew link --overwrite aislop

Check what Homebrew installed:

brew info scanaislop/tap/aislop
brew list scanaislop/tap/aislop

Reinstall from scratch if a release looks wrong:

brew reinstall aislop

Other ways to install

The same CLI is also available on npm, Yarn, Bun, and PyPI:

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

The Homebrew formula installs Ruff and golangci-lint as runtime dependencies, preserving Python and Go lint coverage without a separate tool-setup command.

C# and C/C++ receive built-in text and complexity checks without extra tools. Install the optional system toolchains for project-aware and deeper checks:

brew install cppcheck llvm
brew install --cask dotnet-sdk

C# project evaluation is opt-in for repositories you trust:

lint:
  csharp:
    projectEvaluation: true

Run aislop doctor inside a project to see which checks are available.

See the PyPI package and the main project README for the npm-family options.

For teams

scanaislop is the hosted platform for teams: PR gates with score thresholds, an org → team → project standards hierarchy, dashboards, and agent attribution. Same engines, same scores. The CLI is MIT-licensed and free.

Links

• Discord community: https://discord.gg/Mzz4A6mfj6
• Main project: https://github.com/scanaislop/aislop
• Docs: https://scanaislop.com/docs
• Issues: https://github.com/scanaislop/aislop/issues
• Homebrew tap: https://github.com/scanaislop/homebrew-tap
• PyPI package: https://pypi.org/project/aislop/