vibelint

Lint and analyze AI-assisted coding sessions from the command line.

vibelint inspects your current repository plus local Claude Code session data and reports configuration issues, session quality patterns, and model-usage signals.

Install

Run without installing:

npx vibelint

Or install globally:

npm install -g vibelint
vibelint

Usage

Run it directly with npx:

npx vibelint

Useful flags:

npx vibelint --static
npx vibelint --json
npx vibelint --last 5
npx vibelint --session <id>
npx vibelint --cost

Typical local workflow:

cd /path/to/your/repo
npx vibelint --static
npx vibelint --last 5

Requirements

• Node.js 20 or newer
• A repository you want to inspect
• Local Claude Code data in ~/.claude for session-based analysis

If no Claude Code sessions are available, vibelint can still run static checks with --static.

What It Checks

• Project config quality
• Claude Code permission settings
• Repository context and command coverage
• Conversation efficiency and output quality
• Model-choice mismatch and cost signals
• Cross-session trends

Output Modes

• Default terminal report for interactive use
• --json for CI, scripts, and piping
• --static to avoid session-based analysis
• --cost to focus on model-usage and spend signals

Publish Checklist

Before publishing:

npm test
npm run build
npm pack --dry-run

The published package is expected to contain only the built CLI in dist/ plus package metadata and docs.