Find what is filling a disk, mark what should go, and remove it — with the volume's free space in view the whole time.
disktree is a treemap for Omarchy. Choose a local or SSH source, then a mounted volume or directory; no scan starts until you explicitly accept. It draws every directory as a nested mosaic sized by its real disk cost, and lets you walk into it with the keyboard or the mouse. Mark as much as you like; nothing happens until you review the list and commit, and the permanent path always asks first.
Built with GPUI through gpui-omarchy, so it follows your Omarchy theme and behaves like the rest of the desktop.
Download disktree-*-x86_64-linux.tar.gz (aarch64-linux on ARM) from the
latest release, unpack
it, and run ./install.sh inside (or just copy disktree onto your
PATH). Or build it:
git clone https://github.com/tobi/disktree
cd disktree
make installmake install builds a release binary and puts three things under ~/.local
(no root needed):
~/.local/bin/disktree- a desktop entry, so disktree is in the launcher and in a file manager's Open with for a directory (it adds a handler; it never becomes the default)
- an icon
sudo make install PREFIX=/usr/local installs system-wide; make uninstall
removes exactly what was installed.
On Arch, including Omarchy, disktree is in the AUR:
disktree builds each release
from source, and
disktree-bin installs
the release binary:
yay -S disktree-binIf another installed version wins on PATH, the installer warns which one.
Run export PATH="$HOME/.local/bin:$PATH" and add that setting to your shell
configuration so the locally installed build takes precedence.
For Linux builds with embedded SSH helpers, also install the two Rust standard-library targets (no external C cross-compiler is needed):
rustup target add x86_64-unknown-linux-musl aarch64-unknown-linux-muslYou need Rust 1.97 or newer and a Wayland or X11 session with a GPU that GPUI
can drive (Vulkan). Distributions often package an older Rust;
rustup installs a current one. The repo pins 1.97 in
rust-toolchain.toml, so with rustup the right toolchain is fetched on the
first build even if rustup default points at something older.
Download disktree-*-aarch64-macos.zip (x86_64-macos for an Intel Mac)
from the latest release,
unzip it, and drag disktree.app into Applications. macOS 11 or newer.
A release that was not signed and notarized is stopped by Gatekeeper: macOS says it "is damaged and can't be opened" or "cannot be verified". The app is fine; the browser marked the download as quarantined. Clear the mark once:
xattr -dr com.apple.quarantine /Applications/disktree.app(Or open it once, then choose Open Anyway in System Settings › Privacy & Security.)
Or build it, with Rust 1.97 or newer and Xcode or its Command Line Tools. macOS does not come with Rust; install it with rustup.
make install # ~/Applications/disktree.app, and ~/.local/bin/disktree
make uninstallTo see everything, give disktree Full Disk Access in System Settings › Privacy & Security (the panel offers a button when it is missing), then reopen it. Without it macOS hides Mail, Messages, Safari, other apps' data and the Trash, and disktree counts them as unreadable. Started from a terminal, it is the terminal that needs the access. macOS also asks once each for Desktop, Documents and Downloads.
What is different from Linux:
- Free space is what
dfreports. Finder's figure is larger: it counts purgeable space (caches and local snapshots macOS will clear on its own). - Cloned files (copies APFS shares blocks between, as Finder's Duplicate makes) are each counted in full, so a total can exceed what deleting them frees.
- Time Machine's local snapshots are not files and do not appear; they are part of the gap between the scan and the disk's used space.
- Cloud-only folders (iCloud Drive, Dropbox and the like, evicted to the server) are not opened, so a scan never downloads them.
To sign and notarize a build for others, with a Developer ID certificate in
the keychain and credentials saved by xcrun notarytool store-credentials:
NOTARY_PROFILE=<profile> cargo xtask bundle \
--sign "Developer ID Application: Name (TEAMID)" --notarizeOn Windows 10 or 11, download disktree-*-x86_64-windows.zip
(aarch64-windows on ARM) from the same release, unpack it anywhere and run
disktree.exe. Or build it with Rust 1.97 or newer, from
rustup, and the MSVC toolchain (Visual Studio Build
Tools, C++ workload):
git clone https://github.com/tobi/disktree
cd disktree
cargo build --release # target\release\disktree.exeSee On Windows for what differs there.
disktree # choose a local/SSH source and root
disktree ~ # explicitly scan home
disktree --disk # the whole disk it lives on
disktree ~/src # or any directory
disktree --help # options: apparent size, follow links, skip hidden, …disktree ssh dev # connect and choose a remote root
disktree ssh user@server /var # an explicit remote path
disktree ssh dev --disk # the disk containing the remote home
disktree ssh dev -a /srv # apparent size instead of allocated blocksLinux builds made with make build / cargo xtask portable include static
x86-64 and ARM64 Linux scanners appended to the executable. SSH detects
the server's OS/CPU and uploads the matching scanner only when its checked
cache is missing or damaged. The cache is private and content-addressed under
~/.cache/disktree/ssh/<sha256>/ (or the server's
