🚀 VibeOptimise

The ultimate codebase optimisation scanner for AI-assisted development.

Scan your codebase for dead code, duplication, circular dependencies, bundle bloat, inefficient queries, and more — then get an AI-actionable OPTIMISE.md for Claude Code, Cursor, or any AI agent to fix everything.

By the creator of Vibeguard — the security scanner for vibe coders.

Quick Start

npx @darrenjcoxon/vibeoptimise

That's it. Run it from the root of any JS/TS project.

What It Scans

VibeOptimise runs 10 parallel scanners that cover every dimension of codebase efficiency:

| # | Scanner | What It Finds | Tool | |---|---------|---------------|------| | 1 | Knip | Unused files, exports, dependencies, types | knip | | 2 | JSCPD | Copy/pasted code blocks across the codebase | jscpd | | 3 | Madge | Circular dependencies & orphaned modules | madge | | 4 | Depcheck | Unused & missing npm packages | depcheck | | 5 | BundlePhobia | Heavy deps with lighter alternatives | bundlephobia | | 6 | ESLint Perf | Import cycles, barrel file bloat, unused imports | eslint | | 7 | Source Map Explorer | Bundle composition analysis | source-map-explorer | | 8 | Regex Safety | ReDoS-vulnerable patterns & catastrophic backtracking | Built-in | | 9 | CSS Efficiency | Unused CSS, duplicate selectors, !important overuse | Built-in | | 10 | Query Efficiency | N+1 patterns, unbounded queries, overfetching | Built-in |

Output: OPTIMISE.md

The report is structured for AI agents to work through systematically:

# OPTIMISE.md — Codebase Optimisation Report

## 🔴 Critical — Immediate Performance Impact
- Circular dependencies causing bundle bloat
- ReDoS-vulnerable regex patterns
- N+1 query patterns

## 🟠 High — Significant Optimisation Opportunities
- Unused dependencies (12 packages, ~45MB savings)
- Unbounded database queries

## 🟡 Medium — Recommended Improvements
- Duplicated code blocks (with file pairs + line ranges)
- Heavy deps with lighter alternatives

## 🔵 Low — Nice to Have
- Unused exports, console.log statements
- CSS shorthand opportunities

Usage

# Scan current directory
npx @darrenjcoxon/vibeoptimise

# Scan a specific project
npx @darrenjcoxon/vibeoptimise /path/to/project

# Quiet mode — just generate the report
npx @darrenjcoxon/vibeoptimise --quiet

# JSON output (for CI/CD integration)
npx @darrenjcoxon/vibeoptimise --json

# Include test files in analysis
npx @darrenjcoxon/vibeoptimise --include-tests

# Exclude specific patterns
npx @darrenjcoxon/vibeoptimise --exclude "legacy/**" "vendor/**"

AI Agent Workflow

1. Run npx @darrenjcoxon/vibeoptimise
2. Feed OPTIMISE.md to your AI agent
3. Tell it: "Read OPTIMISE.md and implement all fixes, starting from Critical"
4. Re-run VibeOptimise to verify improvements

Works with Claude Code, Cursor, GitHub Copilot, Windsurf, and any AI coding assistant.

CI/CD Integration

VibeOptimise exits with code 1 when critical or high findings exist — perfect for CI quality gates:

# GitHub Actions
- name: Check codebase optimisation
  run: npx @darrenjcoxon/vibeoptimise --quiet

ORM Support

The Query Efficiency scanner understands:

• Supabase — .from() without .select() or .limit()
• Prisma — Unbounded findMany(), deeply nested includes
• Drizzle — Queries without .limit()
• Mongoose — find({}) without limit, missing .lean()
• Raw SQL — SELECT *, missing LIMIT

Companion Tool: Vibeguard

Use VibeOptimise alongside Vibeguard for complete coverage:

npx @darrenjcoxon/vibeguard      # Security scanning → FIXES.md
npx @darrenjcoxon/vibeoptimise   # Optimisation scanning → OPTIMISE.md

License

MIT — Free for everyone. Built for the vibe coding community. 🤙

Made by Darren Coxon