vibe-check

What energy are you coding in right now?

Run it from your project. Find out.

npx vibe-check

Or install globally:

npm install -g vibe-check
vibe-check

Usage

vibe-check [--path ./src] [--depth quick|deep]

Options:

• --path — Point at a specific directory (default: current directory)
• --depth — quick scans 30 files, deep scans 80 (default: quick)

How it works

Reads real signals from your git history and source files. No APIs. No tracking. Pure local analysis.

Time signals — When do you actually commit? Morning architect or 3am chaos gremlin?

Code signals — Variable names, comment quality, console.log count, test presence, nesting depth, function lengths.

Git signals — Commit message quality, conventional commit ratio, fix chains, WIP commits, frequency trends.

Possible vibes

Vibe	Vibe
CHAOS GREMLIN	Shipping at 2am, variable names are x and y, 47 console.logs, 0 tests.
SENIOR DEV WHO STOPPED CARING	It works. You know it works. Explaining why it works is not your job.
INTERN ON DEADLINE	Stack Overflow is open in 7 tabs. The code works but you cannot explain it.
CAFFEINATED ARCHITECT	Every function has a docstring. Tests for the tests. 6 abstraction layers for a button.
WEEKEND WARRIOR	You shipped 3 repos this week. All READMEs, minimal actual code. The dream lives.
GHOST MODE	Last commit was days ago. The PR has been open for weeks. You are a mystery.
GRIND SEASON	Commit history is a straight line. Morning stand-up to midnight merge. Respect.
VIBE CODER	TypeScript is optional. Tests are a vibe. It runs on your machine.

Example output

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  VIBE CHECK
  Analyzing your current energy...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Current vibe: CHAOS GREMLIN 🦝

"Shipping at 2am, variable names are x and y,
  47 console.logs, 0 tests."

Evidence:
  ⏰  Most commits: 2:00 — DERANGED hours (seriously?)
  🕒  Last commit: 12 min ago
  💬  Last 5 commits: "fix", "fix2", "pls work", ".", "ok"
  📈  This week: 23 commits ↑ (last week: 4)
  📦  14 sus variable names: data, x, res, cb, e, tmp
  🪵  47 console.logs found (bruh)
  🧪  Test coverage: 0% (bold strategy)

Vibe Breakdown:
  Chaos Level     ██████████  85%
  Caffeine Level  ████████░░  95%
  Give-a-damn     █░░░░░░░░░  15%
  Based Factor    █████████░  88%

Diagnosis: You are in the zone. The wrong zone. But a zone.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Requirements

Node.js >= 18. Git installed. That's it.

License

MIT