I wrote a Vibe Check for your code (Runs on a Potato 🥔)

Published: 1 week ago (December 29, 2025 at 02:44 AM EST)

2 min read

Source: Dev.to

You know that feeling when you push code at 3 AM and you’re pretty sure you left a // FIXME: somewhere?
Yeah. We all do.

VibeCheck is a high‑performance Zig CLI tool that scans your codebase for “unfinished vibes”—TODOs, hard‑coded secrets, debug prints, and other signs of developer desperation. It builds to a single ~149 KB static binary with zero runtime dependencies.

What is VibeCheck?

Scans recursively for patterns that indicate unfinished or insecure code.
Runs on any platform that can execute a static binary (Linux, macOS, Windows).
No node_modules black hole, no runtime, just a tiny executable that can even run on a potato 🥔.

Built‑in Pack: Crucial Vibes

Category	Example markers
Desperation	`FIXME`, `TODO`, `XXX`
Mock Data	`lorem ipsum`, `John Doe`
Fragile Paths	`localhost:3000`
Security Laziness	`verify=False`, `chmod 777`

If any of these are found, VibeCheck reports them loudly.

Performance & Size

Size: ~149 KB (statically linked, stripped)
Speed: Scanned a 50 000‑file monorepo in < 1 second
Dependencies: None

It also includes an optional AI Mode with a built‑in MCP (Model Context Protocol) server, allowing integration with Claude Desktop or other LLM tools.

Usage

Human‑readable scan

vibecheck .

Sample output

[WARN] Desperation Marker (FIXME)
  src/main.js:42:10
    | // FIXME: terrible hack, remove before launch

CI/CD integration

Fail the build if vibes are off:

vibecheck . --json   # machine‑readable output

You can also use --github for GitHub Actions annotations.

Features

⚡ Blazing fast: Recursively scans thousands of files in milliseconds.
🪶 Featherweight: ~149 KB static binary, zero dependencies.
📦 Portable: Single executable for Linux, macOS, Windows.
🛡️ Battle‑tested: Validated on a 50 000‑file “Google‑scale” monorepo.
🧩 Modular: Load custom pattern packs via a JSON plugin system.
🤖 CI/CD native: Non‑zero exit codes for build failures, JSON output, GitHub Actions support.
🧠 AI ready: Built‑in MCP server for LLM integration.

Installation

Build from source

# Requirements: Zig 0.13+ and Git
git clone https://github.com/copyleftdev/vibecheck.git
cd vibecheck
zig build -Doptimize=ReleaseSmall

The resulting binary will be placed in zig-out/bin/vibecheck.

Pre‑built binaries (optional)

You can also download ready‑made releases from the GitHub repository’s Releases page.

License

VibeCheck is open source under the MIT License.

View on GitHub – give it a star, try it on your project, and see how “unfinished” those vibes really are.

Happy coding. 🤙