🧹 depclean

Interactive TUI tool to reclaim disk space by cleaning project dependencies

Scan your filesystem, visualize how much space each project's dependencies consume, and selectively delete them — all from a beautiful terminal interface.

Built in Rust for speed. Single binary, zero runtime dependencies, ~650 KB.

Supported Languages

Language	Project Marker	Cleaned Directories
Rust	Cargo.toml	target/
Node.js	package.json	node_modules/
Python	pyproject.toml, setup.py, requirements.txt	venv/, .venv/, __pycache__/
Java / Kotlin	build.gradle, pom.xml	build/, .gradle/, target/
Go	go.mod	vendor/
C / C++	CMakeLists.txt	build/
.NET	*.csproj, *.sln	bin/, obj/

Docker Support

depclean also detects unused Docker images on your system. If Docker is installed and running, it will:

1. List all Docker images
2. Identify which images are not used by any container (running or stopped)
3. Show unused images alongside project dependencies, sorted by size
4. Delete selected images via docker rmi

Docker images appear in the list with the Docker language tag. No configuration needed — if Docker isn't available, this step is silently skipped.

Note: Docker requires administrator privileges. Make sure your user is in the docker group or run depclean with sudo.

Installation

From releases (recommended)

Download the latest binary for your platform from the Releases page.

# Linux (amd64)
curl -L https://github.com/jojo8356/depclean/releases/latest/download/depclean-linux-amd64 -o depclean
chmod +x depclean
sudo mv depclean /usr/local/bin/

# macOS (Apple Silicon)
curl -L https://github.com/jojo8356/depclean/releases/latest/download/depclean-macos-arm64 -o depclean
chmod +x depclean
sudo mv depclean /usr/local/bin/

From source

git clone https://github.com/jojo8356/depclean.git
cd depclean
cargo build --release
cp target/release/depclean ~/.local/bin/

Usage

depclean              # scan current directory
depclean ~            # scan entire home directory
depclean ~/projects   # scan a specific directory

Keybindings

Key	Action
↑ ↓ or k j	Navigate project list
Space	Toggle selection
a	Select / deselect all
Enter	Delete selected dependencies
y / n	Confirm / cancel deletion
q or Esc	Quit

How It Works

1. Scan — Recursively walks the target directory, detecting projects by their marker files
2. Analyze — Calculates the size of each dependency directory
3. Display — Presents projects sorted by size (largest first) in an interactive table
4. Clean — Deletes selected dependency directories after explicit confirmation

Dependencies can always be restored with cargo build, npm install, pip install, etc.

Platforms

Platform	Architecture	Binary
Linux	x86_64	depclean-linux-amd64
Linux	ARM64	depclean-linux-arm64
macOS	x86_64 (Intel)	depclean-macos-amd64
macOS	ARM64 (Apple Silicon)	depclean-macos-arm64
Windows	x86_64	depclean-windows-amd64.exe

License

MIT — see LICENSE for details.