disky

Fast macOS disk analyzer and cleanup CLI in Rust.

Scan 2 million files in seconds, diff snapshots, cleanup safely (Trash-restorable), and pipe JSON to any agent. Alternative to ncdu, dust, du, GrandPerspective, DaisyDisk — built for the terminal AND for AI agents that shell out.

GitHub repo Releases crates.io docs.rs Changelog

Install

cargo install disky

Quick start

disky scan /                   # scan from root (~3 min, 2M files)
disky                          # ncdu-style TUI
disky top --physical           # largest files (APFS-aware)
disky cleanup --apply --reversible    # safe cleanup → ~/.Trash

Why disky

	disky	ncdu	dust	du
Snapshot storage	DuckDB	—	—	—
Diff between scans	yes	—	—	—
Trash-safe cleanup	yes	—	—	—
APFS sparse-file aware	yes	—	—	—
JSON for agents	yes	—	—	—

Agent-native

Every command emits an envelope {schema_version, kind, records}. Errors on stderr follow RFC 9457. Exit codes are stable. Run disky schema for the machine descriptor.