🧹 diskuse

A fast, read-only disk usage browser for macOS and Linux,
inspired by OmniDiskSweeper

⚡️  Quickstart

1. Run diskuse without installing it using uvx diskuse

2. Or browse a specific folder with uvx diskuse ~

3. Press ? to see all the keys

To install it instead, use uv tool install diskuse, pipx install diskuse or cargo install diskuse. Prebuilt binaries for macOS and Linux are also on the releases page.

📋  Features

• As fast as dua and dumac, and faster than dust, pdu, gdu and ncdu (see benchmarks)
• Read-only, it never deletes anything. Reveal an item in Finder with r and delete it yourself
• Three columns like OmniDiskSweeper, with sizes filling in while it scans
• Updates live while open, with a column showing what grew or shrank
• Labels for caches and other large folders, eg. node_modules, target, .venv, Xcode, Docker
• Pick items with space to come back to later
• Works on macOS and Linux

⌨️  Keys

💻  Command Line

diskuse scan ~/src           # print sizes, largest first
diskuse scan ~/src --top 10  # also list the 10 largest files
diskuse scan ~/src --json    # json output for scripts
diskuse show ~/src           # print the last scan again

Sizes are allocated bytes like du -x. Scans stay on one disk, never follow symlinks, and count hard links once.

🔐  Full Disk Access (macOS)

macOS hides some folders like Mail, Messages and Safari from apps without Full Disk Access. diskuse checks this before your first scan and tells you which terminal app needs it. To enable it, turn on your terminal in System Settings > Privacy & Security > Full Disk Access, then restart the terminal. diskuse never asks for sudo.

🏁  Benchmarks

Warm cache on an Apple M4 (10 cores, 24 GB, macOS 27), 3 timed runs each, so differences under about 6% are noise. Every tool's total matched du. See bench/README.md to reproduce.

S1: the dumac README tree, 4,095 folders and 409,500 files

Homebrew: a homebrew prefix, 42,700 folders and 12 GiB. "Best" is each tool at its fastest thread count.

Versions: dua 2.45.1, gdu 5.37.0, dust 1.2.6, pdu 0.24.0, ncdu 2.9.2, DiskScour 0.5.0, diskus 0.9.0, dumac 1ffbe3c3, du (macOS).

🛠  Development

Run just check to format, lint and test, and just demo to re-record the demo above. Benchmarks are run with just bench, see bench/README.md.

Scans are cached in ~/Library/Caches/diskuse (or ~/.cache/diskuse on Linux), which can be changed with DISKUSE_CACHE_DIR. This is the only place diskuse ever writes to.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

🤖  AI Use

diskuse was written with the help of an AI coding assistant (Claude Code). I designed the features, made the decisions, and reviewed and tested every change. The benchmarks are real runs on real machines, see bench/README.md.