diskard

Developer-aware disk cleanup CLI. Scans your machine for reclaimable space from build caches, AI models, package managers, and IDE artifacts.

Why

Developers accumulate tens of GBs of reclaimable space — Xcode DerivedData, npm cache, Ollama models, HuggingFace cache, Docker images, Cargo target dirs, and more. diskard finds them all and lets you clean up safely.

Install

# Via cargo
cargo install diskard

# Via Homebrew
brew install connectwithprakash/tap/diskard

Usage

# Scan for reclaimable space
diskard scan

# Scan with JSON output
diskard scan --format json

# Scan only safe-to-delete items
diskard scan --risk safe

# Scan with minimum size filter
diskard scan --min-size 100MB

# Filter by category
diskard scan --category xcode
diskard scan --category node
diskard scan --category rust

# Sort by risk or category instead of size
diskard scan --sort risk
diskard scan --sort category

# Only show items older than 30 days
diskard scan --older-than 30d

# Combine filters
diskard scan --category xcode --risk safe --min-size 1GB

# Clean (move to Trash by default)
diskard clean --risk safe

# Clean with dry-run
diskard clean --dry-run

# Permanently delete (no Trash)
diskard clean --permanent --risk safe

# Clean a specific category
diskard clean --category node --risk safe -y

# Interactive TUI mode (requires --features tui)
diskard interactive

# List available recognizers
diskard list targets

# Manage config
diskard config init     # Create default config
diskard config show     # Show current config
diskard config path     # Print config file path

# Generate shell completions
diskard completions zsh > ~/.zfunc/_diskard
diskard completions bash > /etc/bash_completion.d/diskard
diskard completions fish > ~/.config/fish/completions/diskard.fish

Recognizers

18 built-in recognizers across 13 categories:

Configuration

Config file location: ~/.config/diskard/config.toml

[defaults]
risk_tolerance = "moderate"
delete_mode = "trash"
min_size = 0

[ignore]
paths = []

[recognizers]
disabled = []

Risk Levels

• Safe — Caches and build artifacts that regenerate automatically
• Moderate — Can be regenerated but may require downloads or time
• Risky — May contain user data or require manual reconfiguration

License

Dual-licensed under MIT or Apache 2.0.