vibecheck-ai-tool 1.0.1

Understand the code your AI wrote

"VibeCheck: The Virtual Senior Developer in Your Terminal"

---

AI-Powered Code Auditing with a "Senior Developer" Vibe.

VibeCheck is an interactive CLI tool designed to help developers understand, audit, and secure their codebase. It combines strict rule-based scanning with advanced AI explanations to ensure you don't just fix bugs—you learn from them.

---

🎬 Cinematic Walkthrough

1. Project-Specific Rules	2. Security Audit
3. Educational Analogies (ELI5)	4. Security Deep-Dive
5. Concept Memory Tracking	6. AI Fix Suggestions
7. Interactive Chat Mode	Ready for Launch

---

✨ Key Features

🛡️ Rule-Based Engine & Local Guidelines

VibeCheck doesn't just use AI; it uses a strict engine to catch SQL Injections, Hardcoded Credentials, and more. Most importantly, it reads your .vibecheck_rules.md to enforce your team's specific coding standards.

🧠 Smart Global Caching

Performance matters. VibeCheck caches every AI response in your home directory (~/.vibecheck/cache). Scan once, and the next scan is instant and completely free.

🎓 Pedagogical AI (ELI5)

Switch to --learn mode to get complex technical flaws explained through simple real-world analogies. Perfect for junior developers and students.

💬 Interactive Terminal Chat

Don't understand a specific issue? Launch --chat mode to have a direct conversation with the "Virtual Senior Developer" about your code.

---

🚀 Quick Start

1. Installation

pip install vibecheck-ai-tool

2. Configure API Key

VibeCheck is universal. It automatically detects your provider.

Provider	Environment Variable	Default Model
Groq (Fastest)	GROQ_API_KEY	llama-3.3-70b
OpenAI	OPENAI_API_KEY	gpt-4o-mini
Anthropic	ANTHROPIC_API_KEY	claude-3.5-sonnet
Google	GOOGLE_API_KEY	gemini-1.5-pro
Ollama	VIBECHECK_ENTERPRISE_MODE=1	ollama/llama3

# Example for Groq
$env:GROQ_API_KEY = "your-key-here"

3. Run Your First Audit

vibecheck examples/python_bad.py --learn

---

👨‍💻 Developed by a 16-Year-Old Creator

Created in 24 hours to prove that AI tools should focus on education, not just automation. Architected & Maintained by Afif Erdita.

---

📄 License

MIT License.