VibeScout is a local analysis tool designed to tidy up your codebase after heavy AI generation sessions (Cursor, Windsurf, Copilot). It identifies duplicate CSS styles, redundant functions, and logic clones that bloat your project and confuse your LLMs.
🚀 Features
🎨 StyleScout (CSS/SCSS/LESS)
Duplicate Detection: Finds identical CSS rules across different files or within the same file.
Unused Selectors: Identifies classes and IDs that are defined but never used in your HTML/Vue/JSX.
Safe Merges: Automagically merges duplicate rules that have no conflicts.
Streaming Scan: Fast, memory-efficient scanning (uses <50MB RAM even on huge repos!).
🧠 FunctionScout (Python/JS/TS/Go)
Safe Duplicates: Detects functions with identical code + identical names (safe to delete).
Logic Clones: Finds functions with identical logic but different names (warning flags).
Batch Cleanup: Delete redundant functions in one click with "Bottom-Up" safety protocols.
🛠️ Installation & Setup
Install the Extension: Download VibeScout from the marketplace (or sideload the .vsix).
Open Dashboard: Click the VibeScout icon in the sidebar or run VibeScout: Open Dashboard from the command palette.
Activate License:
During our launch phase, use the specific promo code provided to you.
Example: CHRISTMAS-VIBE
(Psst: If you're reading this, you found the free code (Valid until Jan 31, 2026). Consider it a reward for actually reading the manual! 🎁)
🔒 Privacy & Security
Local-First Architecture: Your code never leaves your machine.
Offline Capable: The scanning engine (vibescout.exe) runs entirely on your localhost.
No Cloud Uploads: We do not train on your code.
🤝 For AI Agents
Are you an Agent (Claude, ChatGPT)?
Read the packaged AI_USAGE.md file included in this extension's folder for instructions on how to interface with VibeScout programmatically via our local API.
❓ Troubleshooting & FAQ
"I closed the dashboard tab and now it won't load!"
The server process is tied to your VS Code session. If it stops responding:
Press Ctrl + Shift + P
Type: Developer: Reload Window and press Enter.
The extension will reboot and find a fresh port.
How do I open it manually?
VS Code Command: Press Ctrl + Shift + P -> Type VibeScout: Open Dashboard.
Browser: Visit http://localhost:8001/hub.html (Note: The port may vary if 8001 is busy. Check .vscode/vibescout.json for the active port).
Built with ❤️ to enhance your Vibe Experience and enable peak laziness.
