🧠 VibeCheck CLI

"Check yourself before you vibe code yourself."

A real-time checkpoint layer that intercepts every AI agent decision, translates it to plain English, and asks for your approval before anything executes.

🎯 The Problem

Hundreds of millions of people are vibe coding in 2026. AI agents make hundreds of decisions per session — restructuring files, adding dependencies, modifying databases, touching secrets — without ever asking. Students and beginners ship applications they don't understand, can't maintain, and can't fix when they break.

No simple, automated tool exists to give them visibility and control. VibeCheck is that tool.

Install with npm install -g @harshalpatel2868/vibe-check — zero AI, zero API keys, works offline forever.

🚀 Installation

Install globally using npm:

npm install -g @harshalpatel2868/vibe-check

Zero AI dependencies. No API keys. No internet required. Works offline forever.

💻 Quick Start

Navigate to your project folder and start the watcher:

cd your-project
vibecheck start

Now, just leave this terminal open and go write code with your favorite AI agent (Claude Code, Cursor, Copilot, etc.). Every time the AI tries to make a change, VibeCheck intercepts it!

🛠️ Commands

| Command | Description | | --------------------------- | ------------------------------------------------------------ | | vibecheck start | Starts watching the current directory for AI changes | | vibecheck log | Shows a color-coded log of all decisions (approved/rejected) | | vibecheck log --today | Shows logs only from today's session | | vibecheck log --rejected | Shows only the changes you rejected | | vibecheck summary | Generates a clean session summary of what the AI built | | vibecheck rollback <id> | Rolls back a specific decision by ID | | vibecheck rollback --last | Undoes the last approved decision |

⚙️ Configuration

VibeCheck creates a .vibecheck/config.json file in your project root. You can customize the behavior here:

{
  "autoApproveThreshold": ["INFO", "LOW"],
  "ignoredPatterns": [],
  "severityOverrides": {}
}

You can also create a .vibecheckignore file (like .gitignore) in your root directory to ignore specific files or folders.

🧩 The Pattern Library

VibeCheck works by matching simple and complex changes against a known library of patterns.

Severities:

• INFO / LOW: Auto-approved (like adding comments or simple functions)
• MEDIUM: Pauses and prompts (like adding dependencies or using localStorage)
• HIGH: Pauses and warns (like touching API keys or md5 hashing)
• DANGER / CRITICAL: Sirens blaring (like dropping tables or deleting secure data)

Contributing new patterns

Want to add patterns for a specific framework? It's simple! Check out the src/patterns/ directory.

Example src/patterns/general.js addition:

{
  match: /app\.listen\(/,
  severity: 'LOW',
  message: "AI is starting a web server"
}

📜 License

MIT © 2026 Harshal Patel — free to use, modify, and distribute.