Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (vibesweep) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

vibesweep 🧹

Detect and remove AI-generated waste, not the good code. Keep what works, sweep the rest.

The Problem 🚨

41% of all code is now AI-generated (and growing)
4x increase in code duplication since AI coding became mainstream
Only 3.8% of developers trust AI code without review
Companies waste millions in compute/storage on unused code

What is Vibesweep?

Vibesweep identifies waste in AI-generated code - the extra 30-70% that slows down your app:

🧟 Dead Code - Unused variables, functions, and imports that can be deleted
📋 Duplications - Copy-paste code and repeated implementations
🤖 AI Bloat - Verbose comments, TODO placeholders, over-engineered solutions
💸 Real Savings - See exactly what can be removed and how much you'll save

We don't flag good code! Clean, working, efficient code passes with flying colors.

Quick Start 🚀

# Analyze current directory
npx vibesweep analyze .

# Analyze specific directory
npx vibesweep analyze ./src

# Custom file patterns
npx vibesweep analyze . --pattern "**/*.{js,ts}"

# JSON output for CI/CD
npx vibesweep analyze . --output json

# Extract TODO/FIXME comments
npx vibesweep todos .

# Include TODOs in main analysis  
npx vibesweep analyze . --todos

Installation

# Global install
npm install -g vibesweep

# Or use npx (no install needed)
npx vibesweep analyze .

# Add to project
npm install --save-dev vibesweep

Example Output

🧹 Vibesweep Analysis Report
──────────────────────────────────────────────────

📊 Overview:
  Total files analyzed: 127
  Total size: 2.4 MB
  Total waste: 782 KB
  Waste percentage: 32.58%

📈 Summary:
  Files with dead code: 43
  Files with duplications: 28
  AI-generated files: 51

💰 Potential Savings:
  Lines of code: 8,421
  Disk space: 782 KB

🚨 Top Waste Offenders:

  1. src/components/UserDashboard.tsx
     Waste Score: 87%
     Dead Code: 43.20%
     Duplication: 38.50%
     AI Score: 92/100
     Patterns: Verbose AI comments: 23 instances

How It Works

AST Analysis - Parses code using Babel to find unused declarations
Pattern Detection - Identifies common AI generation patterns
Duplication Detection - Uses fuzzy matching to find copy-paste code
Scoring Algorithm - Combines factors into actionable waste scores

CI/CD Integration

GitHub Actions

name: Code Quality
on: [push, pull_request]

jobs:
  vibesweep:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Run Vibesweep
        run: |
          npx vibesweep analyze . --output json > vibesweep-report.json
          waste=$(cat vibesweep-report.json | jq '.wastePercentage')
          if (( $(echo "$waste > 50" | bc -l) )); then
            echo "❌ Code waste exceeds 50%!"
            exit 1
          fi

Pre-commit Hook

#!/bin/sh
# .git/hooks/pre-commit

waste=$(npx vibesweep analyze . --output json | jq '.wastePercentage')
if (( $(echo "$waste > 40" | bc -l) )); then
  echo "⚠️  Warning: Code waste is ${waste}%"
  echo "Run 'vibesweep analyze .' for details"
fi

Configuration

Create .vibesweeprc.json in your project root:

{
  "patterns": ["src/**/*.{js,ts,jsx,tsx}"],
  "ignore": ["**/*.test.*", "**/*.spec.*"],
  "thresholds": {
    "maxWastePercentage": 40,
    "maxDuplicationRatio": 0.15,
    "maxAIScore": 70
  }
}

API Usage

import { GarbageCollector } from 'vibesweep';

const gc = new GarbageCollector();
const analysis = await gc.analyzeProject('./src');

console.log(`Total waste: ${analysis.wastePercentage}%`);
console.log(`Could save ${analysis.summary.estimatedSavings.lines} lines`);

Contributing

We love contributions! Please see CONTRIBUTING.md for guidelines.

The Science Behind It

Vibesweep uses multiple strategies to identify waste (not all AI code):

Dead Code Detection: AST traversal finds truly unused code
Duplication Analysis: Identifies repeated implementations you can consolidate
AI Pattern Recognition: Detects verbose comments and boilerplate, not functionality
Smart Scoring: Only flags what can actually be removed

FAQ

Q: Will this delete my code?
A: No! Vibesweep only analyzes and reports. Cleaning is always manual.

Q: Does it work with all languages?
A: Currently supports JavaScript, TypeScript, JSX, TSX, and Python.

Q: Does this flag all AI code as bad?
A: No! We only detect waste patterns. Good AI code (clean, efficient, used) is not flagged.

Q: What's a good waste score?
A: Under 20% is excellent. 20-40% is normal. Over 40% needs cleanup.

Q: Can I use this in production?
A: Yes! It's read-only and safe to run anywhere.

License

Made with ❤️ by developers tired of AI slop
vibesweep.ai • @vibesweep • Discord