D Clean

Website: codelynther.github.io/dclean

CLI to find and remove development bloat. Scans configured paths, shows sizes in tables, and moves selected items to Trash.

What it scans

• node_modules
• Python venvs (venv, .venv, env, virtualenv)
• NVM Node.js versions
• CocoaPods Pods
• Rust target
• Gradle/Android build and .gradle
• C++ cmake-build-debug
• Flutter build and .dart_tool
• Xcode DerivedData and local build
• AI dev tool data (Cursor, Claude, Antigravity): scan only, no deletion

Installation

npm install -g dclean-cli

Core package (same dclean command):

npm install -g @codelynther/dclean

Try without installing:

npx dclean-cli --init
npx dclean-cli --node-modules --dry-run

From source:

git clone https://github.com/CodeLynther/dclean.git
cd dclean
npm install
npm link

Requires Node.js 20+. macOS and Linux only.

Setup

D Clean does not scan your whole disk. Set scan paths once, then pass flags for what to scan.

Interactive setup

dclean --init

Paths are saved to ~/.dclean/config.json. Legacy ~/.devclean.json is migrated automatically.

Manual config

{
  "scanPaths": ["~/projects", "~/dev", "~/Desktop"]
}

Usage

Nothing runs until you pass a scanner flag:

dclean --node-modules
dclean --python
dclean --nvm
dclean --pods
dclean --rust
dclean --gradle
dclean --cmake
dclean --flutter
dclean --xcode
dclean --ai-dev-tools
dclean --node-modules --pods
dclean --path ~/projects
dclean --dry-run
dclean --no-interactive
dclean --yes
dclean --verbose
dclean --init
dclean --check --silent
dclean --history
dclean --help

Results are sorted by size. Confirmed items go to Trash, not permanent delete.

Check mode

Scan for bloat and get a system notification when thresholds are crossed. Check mode never deletes files and does not prompt you to pick folders to clean. Run dclean separately when you want to review and move items to Trash.

When you run check in a terminal, you see scan progress, the largest folders to clean up, and a cron example. Use --silent for cron jobs so output stays quiet.

Setup: run dclean --init once before using check in cron. Check needs configured scan paths (or pass --path).

Defaults with --check:

• Alert if one category (e.g. Xcode DerivedData) exceeds 5 GB
• Alert if total reclaimable space exceeds 10 GB
• Notifications and terminal summary include the largest folder paths to clean up

Cron example (Sunday 6 PM):

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

Find paths with which node and which dclean. Cron does not load nvm, so use absolute paths.

Scope the check to specific scanners:

dclean --check --xcode --nvm --silent

Safety

• Deletes only under your home directory
• Protected roots (Desktop, Documents, .ssh, Library) cannot be removed; contents inside them can
• Confirmation required unless --yes
• Use --dry-run to preview

Platform support

| Platform | Supported | |----------|-----------| | macOS | Yes | | Linux | Yes | | Windows | No |

Testing

npm test

Dependencies

See DEPENDENCIES.md.

License

MIT