azer/diskwhere

diskwhere is a small command line tool for macOS that helps you figure out what is taking up space on your disk. You run it in your terminal and it shows a text based interface listing folders and files by size, so you can drill down to find the big ones. The README is very short and the tool is deliberately limited in what it can do. The key safety promise is that diskwhere is read only. It does not delete files, does not move anything to the trash, and does not run a cleanup wizard. Its only job is to find what is eating your disk. Once you find a folder or file you want to act on, you press a key to open it in Finder and decide what to do there yourself. Installation is done by cloning the repository and running make or make install, which puts the binary at /usr/local/bin/diskwhere. Building from source needs Go 1.21 or newer and macOS. Usage covers a few commands: the default opens a browser on your home folder, browse takes a specific path, status gives a one shot disk overview, and top lists the largest entries in a directory. Inside the browser you move with arrow keys or vim style j and k, enter directories, jump to home or root, page up and down, rescan, and quit. Inside the browser, pressing o or Option+Enter opens the highlighted item in Finder; the README notes that Cmd+Enter is intercepted by Terminal.app and iTerm2 by default so the o shortcut is the reliable one. The Makefile also exposes targets for running directly with go run, cleaning the binary, formatting and vetting the code, and tidying Go module dependencies.