Vibesweep

CLI Options

Complete reference for all Vibesweep command-line options and flags.

Global Options

These options work with all commands:

--config, -c <path>     Path to config file (default: .vibesweeprc.json)
--quiet, -q            Suppress output except errors
--verbose, -v          Show detailed debug information
--no-color            Disable colored output
--json                Output results as JSON
--help, -h            Show help for command
--version, -V         Show version number

analyze Command Options

vibesweep analyze [path] [options]

Basic Options

--output, -o <format>     Output format: console|json|html (default: console)
--threshold <number>      Fail if waste percentage exceeds threshold
--only <types>           Analyze only specific types (comma-separated)
--exclude <patterns>     Exclude file patterns (comma-separated)
--include <patterns>     Include only matching patterns

Analysis Types

--only-ai-patterns       Only detect AI-generated patterns
--only-dead-code        Only detect dead code
--only-duplication      Only detect duplicates
--skip-ai-patterns      Skip AI pattern detection
--skip-dead-code        Skip dead code detection
--skip-duplication      Skip duplication detection

Performance Options

--max-files <number>     Maximum files to analyze
--parallel <number>      Number of parallel workers
--timeout <seconds>      Analysis timeout per file
--cache                 Use cache for faster re-runs
--no-cache             Disable caching

CI/CD Options

--ci                    Optimize for CI environments
--fail-on-error         Exit with error code on any issue
--fail-on-waste         Exit with error code if waste found
--github-comment        Post results as GitHub PR comment

fix Command Options

vibesweep fix [path] [options]

Fix Options

--dry-run               Preview changes without applying
--only-safe             Only apply safe fixes
--interactive, -i       Confirm each fix interactively
--backup               Create backups before fixing
--no-backup            Skip backup creation

Fix Types

--only-imports          Only fix unused imports
--only-variables        Only fix unused variables
--only-whitespace       Only fix whitespace issues

todos Command Options

vibesweep todos [path] [options]

Todo Options

--format <type>         Output format: list|table|json
--include-fixed         Include already fixed todos
--group-by <field>      Group by: file|type|priority
--sort <field>          Sort by: priority|file|line

Configuration Precedence

Options are applied in this order (later overrides earlier):

  1. Default values
  2. .vibesweeprc.json file
  3. vibesweep.config.js file
  4. Environment variables (VIBESWEEP_*)
  5. Command-line options

Environment Variables

VIBESWEEP_CONFIG        Path to config file
VIBESWEEP_QUIET         Suppress output (true/false)
VIBESWEEP_NO_COLOR      Disable colors (true/false)
VIBESWEEP_CACHE_DIR     Cache directory location
VIBESWEEP_MAX_FILES     Maximum files to analyze

Examples

Basic Analysis

# Analyze current directory
vibesweep analyze .

# Analyze with JSON output
vibesweep analyze . --json > report.json

# Analyze only TypeScript files
vibesweep analyze . --include "*.ts,*.tsx"

CI Integration

# Fail build if waste exceeds 30%
vibesweep analyze . --threshold 30 --ci

# Post results to GitHub PR
vibesweep analyze . --github-comment --fail-on-waste

Performance Tuning

# Use 8 parallel workers for large codebases
vibesweep analyze . --parallel 8 --cache

# Analyze only first 1000 files
vibesweep analyze . --max-files 1000

Selective Analysis

# Only check for AI patterns
vibesweep analyze . --only-ai-patterns

# Skip duplication detection for faster runs
vibesweep analyze . --skip-duplication

Related