Depsweep NPM | npm.io

DepSweep 🧹

Automated dependency cleanup and impact analysis report

Features

Automatically detect and remove unused dependencies

🔍 Smart Detection: Analyzes your codebase to find unused dependencies.
🎯 AST-Based Analysis: Uses Abstract Syntax Tree parsing for precise detection.
🚀 Modern JS/TS Support: Supports the latest JavaScript and TypeScript features.
📦 Package Manager Compatibility: Works with npm, yarn, and pnpm.
🛡️ Safe Mode: Prevents accidental removal of specified dependencies.
🏗️ Monorepo Support: Seamlessly handles projects within monorepos.
⚡ Efficient Processing: Utilizes parallel processing for faster analysis.
🧩 Config File Scanning: Detects dependencies used in configuration files.
🔧 Customizable Ignoring: Allows specifying directory patterns to exclude from scanning.
🧠 Memory Management: Efficiently manages memory usage during analysis.
🏆 Impact Reporting: See the impact of removing unused dependencies.

Supports:

✅ ES Modules and CommonJS
✅ TypeScript and JSX
✅ Dynamic Imports
✅ Configuration Files
✅ Workspace Dependencies
✅ Binary File Detection
✅ Monorepos

Usage

Single Run

# Using npx
npx depsweep

# Using yarn
yarn dlx depsweep

# Using pnpm
pnpm dlx depsweep

Install

# Using npm
npm install -g depsweep

# Using yarn
yarn global add depsweep

# Using pnpm
pnpm add -g depsweep

Options

  -v, --verbose          Display detailed usage information
  -a, --aggressive       Allow removal of protected dependencies
  -s, --safe <deps>      Dependencies that will not be removed
  -i, --ignore <paths>   Patterns to ignore during scanning
  -m, --measure-impact   Measure unused dependency impact
  -d, --dry-run              Run without making changes
  -n, --no-progress          Disable the progress bar
  --version              Display installed version
  -h, --help             Display help information

Examples

# Run with verbose output
depsweep --verbose

# Specify dependencies to protect
depsweep --safe react react-dom

# Ignore specific directories or files
depsweep -i "test/**" "scripts/**"

# Preview changes without removing dependencies
depsweep --dry-run

Protected Dependencies

A list of protected dependencies are ignored by default to prevent accidental removal. Use the -a, --aggressive flag to override this protection. Combine with the -s, --safe flag to enable removal for only some protected dependencies.