Your codebase has more violations than you think.

Every codebase accumulates debt. Not the big architectural decisions — those get debated in PRs. The quiet stuff. The function that does three things. The variable named d. The catch block that swallows errors silently. The magic number buried in a conditional.

Martin's Clean Code has been the standard reference for over fifteen years. Most developers have read it — or at least know they should have. But reading the book and consistently applying its principles across a 50,000-line codebase are very different things.

clean-vibe closes that gap.

How it works

Connect any GitHub repository — public or private — paste in your GitHub token and Anthropic API key, and clean-vibe fetches the full file tree. It estimates scan time per directory so you can run in batches rather than waiting for a monorepo to finish overnight.

Three levels of severity

Not all violations are equal. A magic number in a config file is not the same as a catch block that silently swallows errors in a health data platform. clean-vibe sorts accordingly.

What it actually finds

Here's a real example of what the tool surfaces. A function that looks fine at a glance:

async function proc(d, t) {
  // process the data
  if (d && t === true) {
    try {
      await save(d);
    } catch(e) {
      console.error(e);
    }
  } else {
    return -1;
  }
}

async function saveIfActive(
  record: Record,
  isActive: boolean
): Promise<void> {
  if (!isActive) return;
  try {
    await saveRecord(record);
  } catch (error) {
    showError('Could not save record.');
    throw error;
  }
}

The violations: cryptic parameter names (d, t), a flag argument, a silent catch, an error code return, and a comment describing what the code already says. Five violations in eight lines — none of them obvious without a systematic review.

The two-pass model

Speed matters when you're scanning hundreds of files. clean-vibe uses Claude Haiku for the first pass — fast, cheap, covering every file. The cost for a 200-file repo is roughly $0.15.

After the Haiku pass, any file with blocker-level violations gets a second pass with Claude Sonnet. Sonnet does what Haiku can't: root cause analysis, code smell categorization from Martin's taxonomy, and a concrete refactored example showing the correct approach. This is where the report goes from a list of complaints to an actionable improvement plan.

Zero dependencies. Zero build step.

clean-vibe is a single index.html file. No npm install, no webpack, no server. Open it locally or serve it from any static host. Your API keys stay in your browser — they never pass through any server except Anthropic's and GitHub's directly.

# Clone and open — that's it
git clone https://github.com/Triple-Moon-Goddess/clean-vibe.git
open clean-vibe/index.html

Free for non-commercial use

If you're using clean-vibe for personal projects, learning, or open source work — it's free, forever, no account required. Bring your own Anthropic API key and GitHub token.

Commercial use — at a company, in client work, or as part of a product — requires a license. Three tiers: Individual ($100/year), Team up to 10 developers ($500/year), and Organization unlimited seats ($1,500/year).