A fast, interactive CLI tool to reclaim disk space by finding and deleting stale projects, large files, system caches, and more.

Browse your filesystem interactively, sorted by size - a visual disk usage analyzer in your terminal.

• Navigate directories with vim-style keybindings
• Filter by name or age to find specific items
• Multi-select across directories before batch deletion
• File type breakdown to see what's using space
• Move to trash by default (recoverable) or permanent delete

Find coding projects you haven't touched in months.

• Detects projects by markers (package.json, pyproject.toml, Cargo.toml, go.mod, etc.)
• Shows last opened time, last commit date, and project size
• Supports Node.js, Python, Rust, Go, Ruby, Java, .NET, PHP, Swift, and more

Find big files hogging your storage.

• Configurable size threshold (default 25MB)
• Shows file type, size, and last modified date

Clear browser, package manager, and app caches.

• Cross-platform support (macOS, Linux, Windows)
• 60+ cache locations including:
  • Browsers: Chrome, Firefox, Safari, Edge, Brave, Arc
  • Package Managers: npm, yarn, pnpm, pip, cargo, go, maven, gradle, homebrew
  • Build Tools: Xcode DerivedData, Android SDK, Bazel, ccache
  • Containers: Docker, Podman, Minikube
  • IDEs: VS Code, Cursor, JetBrains, Sublime Text, Vim/Neovim

Reclaim tens of gigabytes from Xcode's caches.

• Simulator Runtimes - Often 5-10+ GB each
• Device Support files
• Derived Data
• Archives
• Documentation Cache
• Smart detection of "latest" versions to keep

Requires Python 3.10 or higher.

# Using uv (recommended)
uv tool install git+https://github.com/sohanmanju/yeet.git

# Using pip
pip install git+https://github.com/sohanmanju/yeet.git

# Don't have Python/uv set up? (macOS)
brew install uv && uv tool install git+https://github.com/sohanmanju/yeet.git

# From source
git clone https://github.com/sohanmanju/yeet.git
cd yeet
pip install -e .

# Interactive mode with menu
yeet

# Scan a specific directory
yeet /path/to/scan

# Customize thresholds
yeet --days 30              # Projects inactive for 30+ days (default: 90)
yeet --min-size 50          # Files larger than 50MB (default: 25)
yeet --min-cache-size 10    # Caches larger than 10MB (default: 1)

# Export scan results to JSON (for scripting)
yeet ~/Library --export results.json
yeet ~/Downloads --export -   # Output to stdout

Yeet stores settings in ~/.config/yeet/config.toml:

[explorer]
start_path = "~"        # Starting directory for disk explorer
min_size_mb = 5         # Minimum size to show in explorer
show_hidden = true      # Show hidden files/directories

[deletion]
use_trash = true        # Move to trash instead of permanent delete
confirm_delete = true   # Ask for confirmation before delete

[scanner]
days_threshold = 90     # Days to consider project stale
large_file_mb = 25      # Minimum size for large files
cache_size_mb = 1       # Minimum cache size to show

[cache]
enabled = true          # Persist size cache to disk
max_age_hours = 24      # Max age of cached sizes

• Move to trash by default - Deleted items can be recovered from system trash
• Interactive confirmation before any deletion
• Preview what will be deleted with total size
• Quit warning if you have items selected
• No automatic deletion - you always choose what to delete
• Caches can be regenerated by apps (safe to delete)
• Warns before deleting system paths

Yeet runs without elevated permissions and cleans up user-owned caches and files. This covers the vast majority of reclaimable disk space.

Some system locations require root/sudo access:

Yeet gracefully skips paths it can't access - no errors, it just won't show them.

• 5x faster directory size calculation using native du command
• Parallel scanning with thread pool for concurrent operations
• Prioritized loading - visible items load first
• Persistent cache - sizes cached for faster subsequent scans
• Bounded memory - LRU cache prevents unbounded growth

A project is considered "stale" based on the most recent of:

• Last file access time
• Last file modification time
• Last git commit date (if it's a git repository)

This ensures recently opened projects aren't marked as stale even if they haven't been committed.

Yeet uses du for accurate disk usage reporting:

• Correctly handles sparse files (VM disk images, containers)
• Reports actual disk usage, not apparent file size
• Handles permission errors gracefully

The scanner automatically detects your operating system and checks common cache locations:

• macOS: ~/Library/Caches, Xcode DerivedData, Homebrew, etc.
• Linux: ~/.cache, ~/.local/share, etc.
• Windows: AppData/Local, AppData/Roaming, etc.

• Rich - Beautiful terminal formatting
• prompt_toolkit - Interactive keyboard navigation

MIT License - see LICENSE for details.

Contributions are welcome! Feel free to:

• Report bugs
• Suggest new cache locations
• Add support for more project types
• Improve documentation

Created by sohanmanju