v0.2.3 Released

Reclaim Your Disk Space

Clean up node_modules, Python venvs, NVM versions, Xcode, and other dev artifacts. Interactive tables, Trash-safe deletes, optional scheduled check alerts.

$ npm install -g dclean-cli

also: npm install -g @codelynther/dclean  |  npx dclean-cli --init

Features

Cleanup for dev machines

Scans paths you configure. You pick what to remove.

๐Ÿ“ฆ

Deep scanning

Finds `node_modules` in nested projects, monorepos, and workspaces.

โœ…

Granular control

Select by age (e.g. older than 3 months) or pick individual folders.

๐Ÿ—‘๏ธ

Trash, not rm

Confirmed items go to Trash so you can recover mistakes.

๐Ÿงฉ

Multi-stack

Python venvs, Rust target, Gradle, Flutter, Xcode, CocoaPods, NVM.

๐Ÿ“Š

Size tables

Sorted by size with last-modified dates in the terminal.

๐Ÿ””

Check mode

Run via cron. Get an OS notification with folder paths when bloat crosses thresholds. Never deletes.

Interactive CLI

โžœ ~ dclean --nvm

๐Ÿงน D Clean v0.2.3

Scanning global locations...

โœ“ Scan complete!

๐Ÿ“— NVM versions (6)

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”

โ”‚ Version โ”‚ Size โ”‚ Last Modified โ”‚

โ”œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ผโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ค

โ”‚ v18.18.2 โ”‚ 380.2 MB โ”‚ 1 year โ”‚

โ”‚ v20.19.2 โ”‚ 361.95 MB โ”‚ 6 months โ”‚

โ”‚ v22.18.0 โ”‚ 167.61 MB โ”‚ 1 month โ”‚

โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”ดโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Subtotal: 1.31 GB

? Check what to delete (space=check/uncheck, enter=confirm)

โฏ โ—ฏ โญ Skip: do not delete anything (exit)

โ—ฏ ๐Ÿ“— NVM versions older than 3 months (2, 742 MB)

โ—ฏ ๐Ÿ“— NVM versions older than 6 months (1, 380 MB)

โ—ฏ โ†ณ ๐Ÿ” Select specific NVM versions...

_

Common Commands

dclean --init

First run setup. Choose folders to scan and save to ~/.dclean/config.json. Required before cron check.

dclean --node-modules

Scan node_modules across your configured paths.

dclean --history

View past cleanups and total space reclaimed.

dclean --check --silent

Cron-friendly. Notifies when one category exceeds 5 GB or total reclaimable space exceeds 10 GB. Never deletes.

Cron setup

Run dclean --init first. Then add a cron line with absolute paths from which node and which dclean:

0 18 * * 0 /path/to/node /path/to/dclean --check --silent

See all options with --help

Back to top