Vibealive
📇 🏠 🍎 🪟 🐧 — Full-featured utility to test Next.js projects for unused files and APIs, with an MCP server that exposes project analysis tools to AI assistants.
Quick Install
{
"mcpServers": {
"skullzarmy-vibealive": {
"command": "npx",
"args": [
"-y",
"skullzarmy-vibealive"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
A framework-aware code analysis tool for Next.js projects. Identify unused files, dead code, and redundant API endpoints to keep your codebase clean and maintainable.
Quick Start
# Analyze your Next.js project
npx vibealive analyze .
# Use in different languages
npx vibealive analyze . --locale es # Spanish
npx vibealive analyze . --locale fr # French
npx vibealive analyze . --locale de # German
npx vibealive analyze . --locale pt # Portuguese
# Start MCP server for IDE integration
npx vibealive serve --stdio
Features
- Smart Analysis: Detects Next.js versions and routing patterns (App Router, Pages Router, hybrid)
- Dependency Tracking: Builds complete dependency graph to find orphaned files
- API Analysis: Identifies unused API endpoints
- Multiple Formats: Generates JSON, Markdown, and other report formats
- MCP Integration: Built-in Model Context Protocol server for IDE/LLM integration
- Build Integration: Webpack plugin and CI/CD pipeline support
- Focused Scans: Specialized analysis for themes, SEO, performance, and comprehensive WCAG 2.2 accessibility compliance
- Internationalization: Multi-language support with community translations
Installation
# Run directly with npx (recommended)
npx vibealive analyze <project-path>
# Or install globally
npm install -g vibealive
Documentation
See the docs directory for complete documentation:
- Overview - Features and capabilities
- CLI Usage - Command-line interface
- MCP Server - Integration with IDEs and tools
- Build Integration - Automated analysis in CI/CD pipelines
- Internationalization - Multi-language support and translation guide
Contributing
We welcome contributions from the community! Please read our Contributing Guide for details on:
- Development setup and workflow
- Code style and testing requirements
- Pull request process and review guidelines
- Types of contributions we're looking for
Please also review our Code of Conduct which outlines our community standards and expectations for respectful collaboration.
License
MIT