cleanx

Clean gitignored files safely across workspaces

Usage

pnpx cleanx

Features

• Gitignore-based cleaning - Uses your existing .gitignore patterns
• Works with single projects and monorepos
• Dry-run mode to preview changes
• Exclude patterns to protect specific files
• Include patterns to override exclusions
• Brace expansion support for patterns

Installation

pnpm add -D cleanx

CLI Options

Clean gitignored files safely across workspaces

Usage:
  cleanx [options]

Options:
      --cwd <path>          Set working directory
  -d, --dry-run             Show what would be deleted without actually deleting
  -e, --exclude <pattern>   Patterns to exclude from deletion (can be used multiple times)
  -i, --include <pattern>   Patterns to include for deletion even if excluded (can be used multiple times)
  -h, --help                Show this help message
  -v, --version             Show version number

Examples

# Preview what will be deleted
pnpx cleanx --dry-run

# Exclude specific patterns
pnpx cleanx --exclude '*.log' --exclude '.env.local'

# Or use shorthand
pnpx cleanx -e '*.env' -e 'node_modules'

# Include patterns to override exclusions
# This excludes node_modules but still cleans the .cache folder inside it
pnpx cleanx --exclude 'node_modules' --include 'node_modules/.cache/**'

# Shorthand version
pnpx cleanx -e 'node_modules' -i 'node_modules/.cache/**'

# Exclude all .env files except .env.example
pnpx cleanx -e '.env*' -i '.env.example'

# Use negation patterns (alternative syntax)
pnpx cleanx -e 'node_modules' -e '!node_modules/.cache/**'

# Use brace expansion to include multiple patterns
pnpx cleanx -e 'node_modules' -i 'node_modules/{.cache,.vite}/**'

# Combine brace expansion with negation
pnpx cleanx -e 'node_modules' -e '!node_modules/{.cache,.vite}/**'