Documentation

Instant scan.

Replace github.com with scanaislop.com on any public repo URL and get a live aislop score in seconds.

The URL hack

Take any GitHub URL like github.com/scanaislop/aislop and swap the host:

github.com/<owner>/<repo>     →     scanaislop.com/<owner>/<repo>

No account. No install. No CLI. You land on a page that runs a real scan against the default branch's HEAD commit and shows the score within a few seconds.

What you see

The 0–100 score, colour-coded green / amber / red.
Error and warning counts, plus scan duration.
The first 20 issues with rule, file:line, severity, and message.
A copy-ready badge snippet for your README.
Links to scan another public repo, view workspace plans, or add a README badge.

How fast

Most public TypeScript and Python repos finish in 5–15 seconds end-to-end:

Same commit and scanner version · instant. The page renders the cached scan immediately.
First visit · ~1s to fetch the repo metadata, ~5–10s to clone and run the engines.
Large monorepo · up to ~30s. Anything over 1 GB is rejected up-front.

What runs

Same engines as aislop scan on your laptop. Deterministic, no LLMs, no network calls beyond the clone:

Format · Lint

Biome, oxlint, ruff, gofmt, clippy, rubocop, php-cs-fixer.

Code Quality

Function/file size, deep nesting, knip dead code, AST-level unused decls.

AI Slop

Narrative comments, as any, swallowed errors, console leftovers, generic names.

Security

Hardcoded secrets, eval, innerHTML, SQL/shell injection, vulnerable deps.

Limits

Public repos only. Private or inaccessible repos are rejected. If you own one, sign in and connect it through the GitHub App.
Repo size cap of 1 GB on the GitHub tarball. Larger repos return a friendly error.
Rate limit of 60 requests / minute / IP on the public-scans API.
Default branch only. Sign in to scan a specific branch, PR, or commit.

Move into a workspace

The instant-scan flow uses a shared public workspace. A paid workspace adds:

Private branch and PR scans via the GitHub App.
PR check runs and inline annotations.
Standards hierarchy (org → team → project) and the visual rules manager.
Per-team dashboards and shared scan history.

Embed the score

Once a public scan exists, the badge service renders it for free. Drop this in your README:

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

See Public badges for the full spec, score bands, and caching layers.