dev-tidy

A powerful CLI tool to clean and optimize JavaScript/TypeScript projects by detecting unused files, dead code, and organizing imports.

📦 npm: https://www.npmjs.com/package/dev-tidy

Features

• Detect unused files
• Delete unused files safely
• Find unused variables and functions
• Cross-file unused symbol detection
• Remove unused variables/functions
• Sort imports automatically
• Dry-run mode for safe preview before making changes

Installation

Run without installing (Recommended)

Use npx:

npx dev-tidy --help

Install globally

npm install -g dev-tidy

Then run:

dev-tidy --help

Install locally in a project

npm install dev-tidy npx dev-tidy

Usage

Run inside your project directory:

dev-tidy [options]

Options

| Option | Description | |-------|-------------| | --unused-files | Find unused files | | --delete-unused | Delete unused files | | --dead-code | Detect unused variables/functions in a file | | --dead-symbols | Detect unused symbols across files | | --delete-dead-symbols | Remove unused symbols | | --fix-imports | Sort imports alphabetically | | --dry-run | Preview changes without modifying files |

Examples

Preview unused files:

npx dev-tidy --unused-files --dry-run

Delete unused files:

npx dev-tidy --unused-files --delete-unused

Find unused symbols:

npx dev-tidy --dead-symbols --dry-run

Remove unused symbols:

npx dev-tidy --dead-symbols --delete-dead-symbols

Sort imports:

npx dev-tidy --fix-imports

How It Works

dev-tidy uses Babel AST analysis to:

• Scan project files
• Track imports and dependencies
• Identify unused files
• Detect unused variables and functions
• Perform safe code cleanup

Tech Stack

• Node.js
• Commander (CLI framework)
• Chalk (terminal styling)
• Babel Parser
• Babel Traverse
• Babel Generator

Why dev-tidy?

Large projects often accumulate unused files and dead code.
dev-tidy helps keep your codebase:

• Clean
• Maintainable
• Optimized
• Easy to understand

Author

Rohit Mondal

License

MI