devclean

Developer disk cleanup CLI — scan and clean build artifacts, caches, dependencies, and runtimes across multiple ecosystems.

Screenshots

Scan

Clean (Interactive Tree Selector)

Supported Ecosystems

Ecosystem	Detection	Artifacts	Status
Node.js	package.json	node_modules, .next, .nuxt, dist, .turbo, .parcel-cache, .svelte-kit, coverage	✅
Node.js + React Native / Expo	ios/Podfile or metro.config.{js,ts,cjs,mjs}	adds ios/Pods, ios/build, ios/DerivedData, android/build, android/.gradle, .expo, .metro	✅
Rust	Cargo.toml	target	✅
Ruby	Gemfile	vendor/bundle, .bundle, tmp, log, coverage, .ruby-lsp	✅
Python	pyproject.toml, setup.py, setup.cfg, requirements.txt, Pipfile, uv.lock	__pycache__, .pytest_cache, .mypy_cache, .ruff_cache, .tox, .nox, .ipynb_checkpoints, __pypackages__, *.egg-info, .venv / venv (caution)	✅
Go	go.mod	vendor (caution; per-project only — global caches handled by the global scanner)	✅
iOS/Xcode (macOS only)	fixed ~/Library/Developer/... paths	DerivedData, Archives, iOS/watchOS/tvOS DeviceSupport, CoreSimulator/Devices, simulator runtimes	✅
Global caches	fixed home paths	~/.npm, pnpm store & cache, Yarn, bun, pip, uv, Homebrew, CocoaPods, Gradle, Go build/module caches, cargo registry, Playwright, Electron, node-gyp, TypeScript, AI tool caches (Claude Code, Codex, Gemini, Cursor), Android AVD/NDK/system-images	✅
LLM model stores	fixed home paths	LM Studio and Hugging Face hub models (per model), Ollama and llamafile stores — with a "last used" hint	✅
Android			planned
Flutter			planned
Docker			planned

See Ecosystems for full detection and safety details.

Features

• Scan for reclaimable disk space across Node.js (incl. React Native / Expo), Rust, Ruby, Python, Go, iOS/Xcode, and more
• Monorepo support — artifacts grouped by git root with sub-package breakdown
• Activity classification — active, recent, stale, dormant (based on git + filesystem)
• Gitignore-aware protection — only git-tracked artifacts are protected
• --min-size filter to suppress small artifacts and focus on real targets
• Accurate sizing — sparse-aware (a 460 GB Docker.raw using 8.6 GB shows as such) and hard-link-aware (shared blocks counted once)
• Interactive tree selector for clean — select by project or individual artifact
• Soft delete (Trash) by default, with force delete option
• Vendor-native cleanup hooks (xcrun simctl delete unavailable, etc.) via --vendor-cleanup
• JSON output (--json) for scripting and AI agents, with apparent_size and a deduped total_size
• Colored terminal output with ecosystem grouping

Install

# Go (Go 1.26+)
go install github.com/ohing504/devclean/cmd/devclean@latest

# Pre-built binary (macOS / Linux, amd64 / arm64)
# Download a tarball from the latest release and put `devclean` on your PATH:
# https://github.com/ohing504/devclean/releases/latest

# From source
git clone https://github.com/ohing504/devclean.git
cd devclean
go build -o devclean ./cmd/devclean

A Homebrew formula is planned for a later release. Until then, use one of the options above.

Usage

# Scan for reclaimable space
devclean scan
devclean scan --path ~/workspace
devclean scan --eco node,rust
devclean scan --status dormant -n 10
devclean scan --json

# Clean up (interactive)
devclean clean --eco node
devclean clean --eco node --status dormant

# Clean up (non-interactive)
devclean clean --eco node --status dormant --yes
devclean clean --safe --dry-run --yes

# Utilities
devclean list

Documentation

• Architecture — system design and scanner patterns
• CLI Commands — full command reference with examples
• Ecosystems — supported ecosystems, detection patterns, and safety levels
• Configuration — settings file spec and options
• Changelog — release notes and version history

Contributing

PRs welcome — see CONTRIBUTING.md for build, test, and PR guidelines, plus a walkthrough for adding a new ecosystem scanner.

License

MIT — © 2026 Youngsup Oh