Command line

NullDisk CLI for macOS and Linux

The same fast scanner as the app, as a single binary for macOS and Linux. Text or JSON reports for terminals, scripts, servers and CI.

nulldisk macOS · Linux Version 1.2.3
macOS · Apple Silicon macOS · Intel Linux · x86_64 Linux · ARM64

Looking for the Mac app? →

Install

Download, extract and put nulldisk on your PATH:

macOS · Apple Silicon

mkdir -p ~/.local/bin && curl -fsSL https://assets.nulldisk.app/releases/cli/nulldisk-latest-macos-arm64.tar.gz | tar -xz -C ~/.local/bin nulldisk

macOS · Intel

mkdir -p ~/.local/bin && curl -fsSL https://assets.nulldisk.app/releases/cli/nulldisk-latest-macos-x86_64.tar.gz | tar -xz -C ~/.local/bin nulldisk

Linux · x86_64

mkdir -p ~/.local/bin && curl -fsSL https://assets.nulldisk.app/releases/cli/nulldisk-latest-linux-x86_64.tar.gz | tar -xz -C ~/.local/bin nulldisk

Linux · ARM64

mkdir -p ~/.local/bin && curl -fsSL https://assets.nulldisk.app/releases/cli/nulldisk-latest-linux-arm64.tar.gz | tar -xz -C ~/.local/bin nulldisk

Usage

nulldisk                                     # interactive terminal UI
nulldisk ui ~/code                            # live disk map with a treemap
nulldisk dev -i                               # review development clutter
nulldisk dev ~/code --older-than 30d          # report rebuildable files, worktrees
nulldisk clean ~/code --older-than 30d        # preview development cleanup
nulldisk scan ~/Downloads                     # text tree, 2 levels, top 20
nulldisk scan / --depth 1 --top 10
nulldisk scan /var --json > var.json          # one JSON report for scripts
nulldisk scan ~/code --profile dev --jobs 8
nulldisk open ~/Downloads                     # macOS: open the folder in NullDisk

Review before cleanup

nulldisk clean previews its selections by default. Review the paths and Git evidence before adding --yes to move eligible output to Trash.

Servers and SSH

The Linux builds are fully static, so you can copy them to any server and run them over SSH. The NullDisk Mac app can also scan remote Linux hosts over SSH by itself; it uploads its own small helper, so there is nothing to set up.

scp ~/Downloads/nulldisk user@server:~/nulldisk
ssh user@server '~/nulldisk scan /srv --depth 1 --json' > srv.json

SHA-256 checksums

nulldisk-1.2.3-macos-arm64.tar.gz 43b526f469ef597f8f73a88bf8d4061600023e4c889cc0a3a0b226bb73856969
nulldisk-1.2.3-macos-x86_64.tar.gz bcda44199856dae2705b06afd145a4f50105ff991a0f4dccb485d544c0c12556
nulldisk-1.2.3-linux-x86_64.tar.gz e8f210801c3500ed7633b44403f1c27546a2bb977b1c4e08784195be29289b5c
nulldisk-1.2.3-linux-arm64.tar.gz d0d0d7d1b23343b7a171b29432ae16876af2b18ab2807df83df4cf0a3e08e222 
shasum -a 256 -c nulldisk-*.tar.gz.sha256