dev-clean

Detect and kill lingering dev server processes.

日本語

Install

Run directly with npx:

npx dev-clean

Or install globally:

npm i -g dev-clean

Usage

# Scan current directory for dev processes and kill them
dev-clean

# Skip confirmation prompt
dev-clean --yes

# Scan a specific project directory
dev-clean --cwd ~/projects/my-app

# Find processes on specific ports
dev-clean --port 3000

Options

| Option | Alias | Description | | --- | --- | --- | | --cwd <path> | | Target project path (default: current directory) | | --port <ports> | -p | Port(s) to check (e.g. 3000, 3000-3005, 3000,5173) | | --yes | -y | Kill without confirmation | | --json | | Output as JSON (to stdout) | | --dry-run | | Detect only, don't kill | | --version | -v | Show version | | --help | -h | Show help |

Examples

Kill processes on a specific port

dev-clean --port 3000

Kill processes on multiple ports

dev-clean --port 3000,5173

Kill processes on a port range

dev-clean --port 3000-3005

Scan a different directory

dev-clean --cwd ~/projects/my-app

Dry run (detect without killing)

dev-clean --dry-run

JSON output

dev-clean --json --yes

Supported Platforms

• Windows
• macOS (unverified)
• Linux (unverified)

Requires Node.js >= 18.3.0.

License

MIT