reclaimed: Fast, Light & Powerful, Your Go-To Disk Space Savior for macOS, Linux, and Windows, Totally Free

What is reclaimed?

reclaimed is a cross-platform, ultra-lightweight, and surprisingly powerful command-line tool for analyzing disk usage, with special handling for iCloud storage on macOS.

Quickly find your largest files and directories with a beautiful, color-coded interface, and manage them through an interactive terminal UI.
Fully supports Linux, macOS, and Windows.

Features

• Legitimately Performant: Fast recursive directory scanning with ultra-efficient progress updates.
  • Carefully tuned repaint frequency, optimized to avoid slowing results by even 5ms.
  • Separate thread for the clock to keep real-time updates buttery smooth.
• iCloud Aware: Detects and handles iCloud Drive symlink files vs local storage (macOS).
• Beautiful UI: Powered by Textualize/rich and Textualize/textual.
  • Full keyboard navigation, mouse support, and customizable themes.
• Interactive Terminal UI: Browse, manage, and delete files/directories with ease.
• Safe Deletion: Remove large files and directories directly from the interface, with confirmation prompts.
• Export to JSON: Save scan results for further analysis or batch operations.
• Real-Time Feedback: Live progress indicators and graceful handling of permission issues.
• Actual Privacy: 100% offline. No telemetry, no analytics, no tracking - can't even check for updates.
• CLI-Mode: Real-time progress indicator (files scanned, total size)
• CLI-Mode: Tables of largest files and directories
• CLI-Mode: iCloud vs local storage clearly indicated
• CLI-Mode: Summary of any access issues
• Tabbed interface: switch between Files and Directories
• Keyboard navigation (arrow keys) and mouse support
• Sort items by size, name, or path
• Delete files/directories with confirmation
• Refresh scan results

Install

Prerequisites

• Python 3.8+
• pip (Python package installer)
• (Optional but recommended) Use a virtual environment

uvx (fastest)

uvx reclaimed

Install via pip

pip install reclaimed

Install via Homebrew (macOS)

brew install taylorwilsdon/tap/reclaimed

Build from Source

git clone https://github.com/taylorwilsdon/reclaimed.git
cd reclaimed
pip install -e .

Use

reclaimed ~/Documents

# Show more results
reclaimed ~/Documents --files 20 --dirs 15

# Skip specific directories during scanning
reclaimed ~/Documents --skip-dirs node_modules --skip-dirs __pycache__

# Save results to JSON
reclaimed ~/Documents --output results.json

License

This project is licensed under the MIT License.

Resources & Source-code Downloads

• Github

GitHub - taylorwilsdon/reclaimed: Fast, light and useful - reclaimed is a disk space utilization & cleanup application for macOS, Linux & Windows

Fast, light and useful - reclaimed is a disk space utilization & cleanup application for macOS, Linux & Windows - taylorwilsdon/reclaimed

GitHubtaylorwilsdon