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, scan duration, total file count.
The first 20 issues with rule, file:line, severity, and message.
A copy-ready badge snippet for your README.
A "Claim this repo" link to take ownership and unlock private scans, PR gates, and the full dashboard.

How fast

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

Repeat visit within 6 hours · 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 100MB 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 repos return a "sign in" CTA pointing at the dashboard's GitHub App connection flow.
Repo size cap of 100MB 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.

Claim a repo

The instant-scan flow uses a shared "public" workspace. Hitting Claim this repo on the result page transfers the project into your scanaislop org and unlocks:

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 agent attribution.

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.

Reserved paths

A few top-level slugs are reserved for the marketing site itself and never trigger a scan:

/docs   /pricing   /blog   /changelog   /agents   /api   /app   /badges
/ci     /commands  /configure  /guides   /hooks   /languages   /rules
/skill  /terms     /privacy    /writing-comments  /llms.txt    /sitemap.xml