Docs - vibereport

Documentation

Install, scan, and understand your vibe score.

# Install

macOS / Linux 
curl -fsSL https://vibereport.dev/install.sh | sh
Windows (PowerShell) 
irm https://vibereport.dev/install.ps1 | iex
cargo 
cargo install vibereport

Cargo requires Rust installed on your system.

# Usage

Four ways to scan a repo:

Scan current or specific repo

vibereport
vibereport /path/to/repo

Scan all git repos recursively

vibereport --scan-all ~/projects

Scan a remote GitHub repo

vibereport github:user/repo

Scan online

vibereport.dev/scan — no install required

# Options

Flags you can combine with any scan mode.

Filter commits by date

vibereport --since 2025-01-01
vibereport --since 6m
vibereport --since 1y
Accepted values: YYYY-MM-DD, 6m, 1y, 2y, or all (default).

Keep results private

vibereport --no-share
By default, results are shared to the community leaderboard. Use this flag to disable sharing.

JSON output

vibereport --json
Machine-readable output for CI pipelines and scripts.

SVG export

vibereport --svg report.svg
Generates a shareable image. Combine with other flags freely.

Flags can be combined: vibereport --since 6m --json --no-share

# What gets scanned

+

Commit messages only — Co-Authored-By trailers, email patterns, and message prefixes

-

NO source code is read or uploaded

-

NO secrets, credentials, or private data are accessed

The scan result (commit stats + score) is shared to the community by default.

Keep results private:

vibereport --no-share

# Detected AI tools

Detection is based on commit message signatures (Co-Authored-By trailers, email patterns, message prefixes).

Claude Code
Cursor
Aider
Codex CLI
GitHub Copilot
Gemini CLI

Tools that don't sign commits are not detectable: Windsurf, Copilot inline autocomplete, Kilo Code.

# Scoring

AI%

ai_commits / total_commits × 100

Factual metric. How many commits have AI tool signatures.

Vibe Score

Composite judgment score. Higher = more vibes detected.

AI ratio 0–60 pts
No tests +20
Few tests (<3) +10
.env in git +20/file (max 60)
Hardcoded secrets +20/each (max 60)
No linting +10
No CI/CD +10
Boomer AI +10
node_modules in git +15
Mega commit +10
No .gitignore +10
No README +10
TODO flood (>20) +5
Single branch +5

Score is uncapped — repos with enough chaos can exceed 100 for an S+ grade.

Boomer AI: AI% > 0 but no config files found (.claude/, .cursorrules, AGENTS.md, etc.)