Clean up unused npm deps!

Finds unused npm packages and helps you sweep them away — safely.

$ deps-janitor

🧹 Checking the halls for messes...

🗂️ Found 11 files to inspect

🧹 deps-janitor reporting for duty!

🏢 Building: deps-janitor

🛠️ Tools: npm

🔍 Time to sweep for dusty packages...

🧽 Dusting off: @types/react

🧽 Dusting off: @types/react-dom

🧽 Dusting off: eslint-config-next

🧹 Swept through 10 packages

🗂️ Found 3 dusty packages collecting cobwebs:

1. 📦 react-dom

2. 📦 eslint-config-next

3. 📦 tailwindcss

🧹 Clean sweep? Remove all dusty packages? (y/n): n

found 0 vulnerabilities

✨ tailwindcss swept away!

🧹 Cleaning Report:

🗑️ Tossed: 1

✨ Kept tidy: 7

⏭️ Skipped: 2

✨ All clean! Building's looking sharp.

Features

Everything you need to keep your dependency list tidy

Smart Sweeping: Finds dependencies that are truly unused — not just suspicious-looking ones
Thorough Inspection: Understands ES imports, CommonJS, dynamic imports, and subpaths
VIP Treatment: Knows when to leave important tools alone (configs, build tools, types)
Friendly Chat: Always asks before removing anything — no surprise cleanups
Multi-Tool Support: Plays nicely with npm, yarn, and pnpm
Building Aware: Handles basic monorepos without getting confused
Inspection Mode: Dry-run mode lets you preview the mess before cleaning it
Quick Work: Caches files so cleanup stays fast, even in big projects

One command. A cleaner dependency list.

deps-janitor

deps-janitor --dry-run

Preview what would be removed

deps-janitor --debug

Show detailed analysis

{
  "scripts": {
    "cleanup-deps": "deps-janitor"
  }
}

Want deps-janitor to ignore certain packages? Drop a .cleanupdepsrc file in your project root:

{
  "ignore": ["eslint", "prettier"],
  "ignorePatterns": ["@types/*", "*-loader"]
}

ignore: Array of package names to always keep (exact matches)

ignorePatterns: Array of glob patterns for packages to ignore (supports wildcards)

💡 Tip: Start with the included .cleanupdepsrc.example, then tweak it as needed.

No guesswork. Just careful inspection and polite questions.

File Scanning: Walks through your project files (skipping the usual junk)
Import Analysis: Looks for real usage across common patterns:
- ES6 imports: import ... from 'package'
- CommonJS: require('package')
- Dynamic imports: import('package')
- Subpath imports: from 'package/subpath'
Special Cases: Recognizes configs, build tools, and setup-only packages
Script Analysis: Checks npm scripts for hidden usage
Interactive Removal: Nothing gets removed without your approval