use caseofficial ogbuilds guide

Code quality checker: score a whole repo from its GitHub link

By ogbuilds, the studio behind clean·vibes · updated 2026-07-16

the short answer

A code quality checker measures how maintainable and clean your code is — structure, duplication, dead code, readability, consistency, and repo hygiene — rather than whether it runs or passes tests; clean·vibes is a code quality checker for a whole repository: paste a public GitHub link and it returns a 0–100 score with a letter grade, six category subscores, and every issue pinned to a file and line with a fix, in under a minute.

A code quality checker answers a question your test suite can't: not "does this work?" but "how much trouble is this code going to be to live with?" Working code and clean code are different things — a repo can pass every test and still be a maze of duplicated blocks, dead code, and 1,200-line files that make the next change slow and risky.

a clean·vibes code-quality report scoring a repo 89/100 with six subscores — structure & size flagged at 56 while duplication and repo hygiene score 100
a whole-repo quality check: one score, six category subscores, and exactly where the repo is weak

What a code quality checker measures (and what it doesn't)

Quality here means maintainability, not correctness. A code quality checker looks at the shape of the code: how big the files and functions are, how deeply nested the logic gets, whether the same block is copy-pasted across files, whether dead and commented-out code is piling up, whether naming and conventions are consistent, and whether the repo has the basics — a README, a .gitignore, a lockfile. None of that changes whether the app runs today; all of it changes how hard tomorrow's change will be.

It is not a bug finder and not a test runner. A checker won't tell you the app is broken — it tells you the app is expensive to change, which is the problem that shows up three months in when a "quick" edit touches six duplicated copies. clean·vibes scores exactly these six categories, each starting at 100 and losing points per finding by severity, combined into one weighted 0–100 score.

Whole-repo checker vs. a linter

A linter (ESLint, Ruff, and friends) checks one file at a time against style and syntax rules — invaluable, and you should run one, but it can't see the repo. Cross-file duplication, a module nobody imports anymore, a codebase that's inconsistent between its old half and its new half — these only exist at the whole-repo level, and a per-file linter is blind to them by design.

A whole-repo code quality checker reads the codebase as one thing. That's the level where maintainability actually lives, and it's what clean·vibes scores: it streams the repo archive in memory, runs deterministic heuristics across the whole tree, then adds a Claude review pass that reads for the judgment calls rules miss — the two together producing a score, a ranked findings list, and a fix for each.

How to check a repo's quality in under a minute

Paste the GitHub link. clean·vibes fetches the same public archive anyone can download — no OAuth, nothing written to disk — and returns a 0–100 score with a letter grade (A ≥90 down to F), the six category subscores so you can see whether the problem is structure or duplication or hygiene, and every finding with its file, line, and a one-paste Claude prompt to fix it. Private repos work too, via sign in with GitHub.

The score is the summary; the subscores are the diagnosis. A repo scoring 78 with structure at 45 and everything else near 100 has one specific, fixable problem — oversized files — not a vague "needs cleanup." That's the difference between a checker that grades you and one that tells you what to do next.

how it works

  1. 01

    Paste a GitHub link

    Public repos need nothing but the URL; private repos work via sign in with GitHub. The archive is streamed in memory, never written to disk.

  2. 02

    Read the overall score

    0–100 with a letter grade (A ≥90, B ≥80, C ≥65, D ≥50, F below) — the one-number summary of maintainability.

  3. 03

    Use the six subscores as a diagnosis

    Structure, readability, duplication, dead code, consistency, hygiene — the low bar tells you what kind of mess it is, not just that there is one.

  4. 04

    Work the findings list

    Each issue comes with a file, line, why it matters, and a ready-to-paste Claude prompt with behaviour-preserving constraints.

  5. 05

    Re-check to confirm

    Fix, re-scan, watch the score move. The free tier covers about five scans a month.

frequently asked

Is a code quality checker the same as a linter?

No. A linter checks one file at a time for style and syntax; a code quality checker reads the whole repo for maintainability — cross-file duplication, dead modules, oversized files, inconsistency. Run both: the linter for per-file rules, the checker for the repo-level picture.

Does it check quality or find bugs?

Quality — how maintainable and clean the code is, not whether it's correct. It won't tell you the app is broken; it tells you the app is expensive to change, which is the problem tests don't catch.

Do I need to install anything?

No. clean·vibes runs from a GitHub link in the browser — paste the URL, get a scored report in under a minute. Nothing to install, nothing cloned to your machine, nothing written to disk on ours.

Can I check a repo I didn't write?

Yes, as long as it's public — which makes it useful for sizing up a codebase before you inherit it or a dependency before you adopt it. Paste the link and read the score and subscores.

Last updated July 16, 2026

ready to try clean·vibes?

score your repo