[Harold Hunt (huntharo)]

PwrDisk previously required a GPUI window for interactive exploration and review. This ports Jeremy Dixon’s terminal interface from tobi/disktree#62 as the standalone pwrdisk-tui executable, backed by the shared scanning core without GPUI dependencies:

pwrdisk-tui ~/src
pwrdisk-tui --apparent-size ~/src
pwrdisk-tui --disk ~/src

The terminal offers the upstream mosaic, inspector, findings, free-space bar, keyboard navigation, scrolling list, search, marking, review and prompt export. The list includes empty directories that have no treemap area. It adapts from a 120-column mosaic and inspector to an 80-column map and a 45-column list.

The first two commits retain Jeremy Dixon’s authorship and cherry-pick provenance: d738be0 introduces the interface; bad1769 adds the empty-match navigation regression. The core half of the latter is already on main through #34. PwrDisk adaptations and verification follow in separate commits.

make build-tui and make install-tui build and install only the terminal. Normal installation includes both executables. Linux release packaging supplies a static-musl terminal, including a terminal-only tarball; macOS bundles carry a separately signed terminal binary, and Windows packages include pwrdisk-tui.exe. CI builds static Linux x64 and ARM64 terminals without installing desktop libraries and uploads them as artifacts.

PwrDisk adaptations require an explicit root, use current path/category and clone accounting, and share the desktop’s persisted removal-capacity setting. Local removal retains guarded review, confirmation and worker remeasurement. Windows file targets query capacity through their containing directory. SSH terminal sessions permit inspection, marking and export. A native link fixture uses the existing deterministic theme initializer so filesystem callbacks cannot wake the test scheduler from another thread.

The TUI owns its scan and marks in memory; neither interface currently saves or loads a complete scan. It does not host MCP or connect to the desktop session. #39 remains responsible for desktop-owned MCP and explicit standalone MCP. Starting a terminal session on macOS does not delegate its scan to the permissioned desktop.

The shared node remains 104 bytes. Hidden and Disk/Apparent changes rescan while retaining resolvable paths and marks; Size/Files/Age changes reuse the tree.

Verification at 49bfb05	Result
macOS 27.0.1 arm64	Lint, full workspace tests, an isolated terminal release build, signed app bundle, and both temporary installation paths pass
Ubuntu 24.04.5 x86_64, Sandboxer sb_wygssy8d54	Lint, full workspace tests, portable desktop plus static terminal build, and packaged installer pass
Actual PTY on macOS and Linux	With DISPLAY/WAYLAND_DISPLAY absent: renders a completed contrived scan, quits with q, restores the terminal, and leaves the fixture intact
Linux terminal linkage	Stripped 1.9 MB static PIE with no dynamic loader; no GPUI dependency in the terminal Cargo tree
Workflow files	actionlint passes
Windows and packaged universal builds	Fresh CI and the packaging preview provide native platform checks; pending

The empty-match GPUI regression covers the real benefit established during investigation: a drawn positive-size ancestor of an empty matching directory retains its “holds matches” styling and readable label. MCP search uses a separate query implementation and already finds empty matches. An all-empty filtered treemap still has zero tiles.

Before this PR there is no terminal UI to capture. The following captures come from the actual Ratatui TestBackend renderer over a synthetic /Fixtures tree, with an invented volume, capacity, free space and timing; the exported cell buffers were rasterized to PNG. They contain no real scan or volume data.

120 columns:

80 columns:

45 columns: