Skip to content
pwrdrvrPublic
forked from tobi/disktree

About

Find what's eating your disk, review it, remove it. A maintained fork of tobi/disktree.

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

 
 

Repository files navigation

PwrDisk

See what is filling your disk. Get the space back safely.

Your whole drive as one map, every folder drawn to its real size.
Mark what should go, review the list, and watch the free space come back.
macOS, Windows and Linux.

Download for Mac — Universal, Intel and Apple Silicon Download for Windows — x64 installer Download for Windows — ARM64 installer

Download for Linux — x86-64 tarball Download for Linux — ARM64 tarball

macOS 11 Big Sur or newer · Windows 10 or newer, x64 and ARM64 · Linux x86-64 and ARM64 · MIT
Signed and notarized for macOS, signed for Windows, and both keep themselves up to date. No account, no telemetry.



PwrDisk scanning a home folder on a 1 TiB disk with 21 GiB free. Each folder is a tile sized by its space and coloured by kind: Projects with its Rust target folders and node_modules, agent worktrees, movies, local AI models, photos, Dropbox, caches and toolchains. Reclaimable space is hatched. The side panel shows the selected Projects folder at 185 GiB, a Worth a look list led by .cache at 69 GiB, and the disk meter.

Why PwrDisk

Disks fill up slowly and then all at once. PwrDisk shows you where the space went in one picture, and gets it back without the "wait, what did I just delete?" moment.

  • The whole drive at a glance. Every folder is a tile sized by what it really costs on disk, coloured by what it holds: code, caches, toolchains, synced files, media, documents. Space you can safely get back — caches, build output, package stores — is hatched.
  • Worth a look. The side panel lists the biggest things that could plausibly go, so you don't have to go hunting.
  • Free space, live. The meter shows the drive's free space now and after what you have marked, and only counts what would actually come back to that drive.
  • Marking is never deleting. Mark as much as you like and change your mind as often as you like. Nothing happens until you open the review list and confirm. The default is the Trash or Recycle Bin; deleting permanently always asks first.
  • Guard rails you don't have to think about. PwrDisk refuses to remove system folders, your home folder, mount points or anything outside what you scanned. Select a git checkout and it tells you about uncommitted changes, stashes and unpushed commits before you mark it.
  • Fast. A home directory takes seconds. On Windows, run it as administrator and it reads a whole NTFS drive straight from the file table — about 3.4 seconds for 4 million files.
  • Servers too. Scan a Linux server over SSH, read-only. PwrDisk never deletes over SSH; it hands you the list, or a delete script that checks it is on the right machine first.
  • Let an AI agent do the digging. Claude Code, Codex or any MCP client can scan, explain and mark for you. You confirm every removal.

Install

Platform Download Notes
macOS 11 or newer PwrDisk.dmg Universal: Apple Silicon and Intel. Open it and drag PwrDisk to Applications.
Windows 10 / 11, x64 PwrDisk-win-Setup.exe Installs for you alone, no administrator prompt.
Windows 10 / 11, ARM64 PwrDisk-win-arm64-Setup.exe The same, for ARM PCs.
Windows, for deployment tools x64 .msi · ARM64 .msi Installs the same way as Setup.exe.
Windows, portable x64 .zip · ARM64 .zip Runs from wherever you unpack it.
Linux, x86-64 pwrdisk-x86_64-linux.tar.gz Unpack and run ./install.sh.
Linux, ARM64 pwrdisk-aarch64-linux.tar.gz The same, for ARM.

Every release, with checksums, is on the releases page.

macOS. The app is signed with a Developer ID and notarized by Apple, so it opens like any other download. To measure everything, give PwrDisk Full Disk Access in System Settings › Privacy & Security (the side 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 PwrDisk shows them as unreadable rather than guessing.

Windows. Installers are signed by PwrDrvr LLC and land in the Start menu; uninstall from Settings › Apps. When PwrDisk would be faster or see more as administrator, the side panel offers Restart as Administrator.

Linux. No root needed; this installs into ~/.local with a launcher entry and an icon. Use aarch64 in place of x86_64 on ARM:

curl -fL https://github.com/pwrdrvr/PwrDisk/releases/latest/download/pwrdisk-x86_64-linux.tar.gz | tar xz
cd pwrdisk-*-x86_64-linux && ./install.sh

You need a Wayland or X11 session with a GPU that does Vulkan. On Omarchy PwrDisk follows your theme; on Hyprland, see the window rules.

Updates. The Mac app and Windows installs check for a new release when they start and every six hours, download it in the background, and install it when you quit (or right away from Restart to update). Shift-U shows the version and lets you pick a release channel. The Linux tarball does not update itself; download the next release.

Using it

Settings › General › Size units follows your platform by default: decimal on macOS (kB, MB, GB), binary on Windows and Linux (KiB, MiB, GiB). Choose Decimal or Binary to save an explicit preference for the window and human-readable agent reports.

  1. Pick what to scan. Choose This computer or an SSH host, then a drive or folder. Nothing is scanned until you choose.
  2. Look around. Click a tile, or use the arrow keys. Scroll or pinch to zoom into a folder and keep pushing to go inside, one level per swipe; scroll back to come out. Drag to pan while zoomed in. Enter opens the selected folder, Backspace goes up.
  3. Mark what should go. Space marks the tile under the pointer; press it again to unmark. The side panel shows how much free space you would have afterwards.
  4. Review. Press c to see the list. Unmark anything you are unsure of, then Enter moves the rest to the Trash or Recycle Bin. p deletes permanently instead, after asking.
  5. See the result. PwrDisk shows how much space you actually got back, without scanning again: what went stays in the treemap, greyed out, until you rescan. Move & rescan (shift-Enter) scans afterwards instead.
key does
space mark or unmark
enter / ⌫ open the folder / go up
scroll or pinch zoom in, then push to go inside
/ filter by name
c review what is marked
t colour by size, file count or age
g scan the whole disk
o show in Finder, File Explorer or the file manager
? every key

From a terminal:

pwrdisk            # choose a source and a folder
pwrdisk ~/src      # scan a folder straight away
pwrdisk --disk     # the whole disk
pwrdisk ssh myserver /var   # a server over SSH, read-only
pwrdisk report -D -o today.jsonl   # folders of 100 MB or more, no window
pwrdisk report-diff monday.jsonl today.jsonl   # where the space went

The user guide covers every screen and key, how sizes are measured, SSH, and what differs on macOS and Windows. Usage reports explains what a report keeps and what a comparison of two can and cannot say.

With an AI agent

PwrDisk is also an MCP server. Connect it after starting PwrDisk and ask your agent what is eating your disk:

claude mcp add --scope user pwrdisk -- pwrdisk mcp   # Claude Code
codex mcp add pwrdisk -- pwrdisk mcp                 # Codex

The desktop must already be running. The command is a transport relay; the desktop owns tools, schemas, instructions, skills, resources, prompts and execution. MCP never launches PwrDisk. If the desktop is unavailable, start it yourself and reconnect MCP in the client. For an independent scanner, explicitly use pwrdisk mcp --standalone; that process owns its own interface, scans and marks, and cannot remove files or drive a window.

Relative tool paths resolve against the relay's working directory captured when MCP connects, independently of the desktop's launch directory or scan root. Initialization metadata (pathBase) and status report that fixed base. ~ refers to the server's home directory. Older relays that supply no base require absolute paths or ~/…; reconnect with an updated relay to enable relative paths. Standalone captures its own working directory.

On macOS the command lives inside the app. Settings › Agents (MCP) shows the command line and each client's command with the full path and a Copy button; Help › Connect an AI Agent (MCP)… and the line under the disk open it.

The agent walks the tree, lists every cache and build directory, and proposes what can go. You can confirm in PwrDisk's review screen yourself, or explicitly approve an exact removal preview for the destructive MCP removal tool. Approval to mark never authorizes removal. Agents must never approve through computer use. Trash may be recoverable until emptied; permanent deletion cannot be undone through PwrDisk. Settings > Safety limits each operation to 5% of each volume's capacity by default. If a PwrDisk window is open, you both look at the same map and its marks show up as the agent makes them. MCP confirmation can also reach you through PwrAgent messaging; see the approval and client contract. More in the guide.

What PwrDisk will not delete

Only things inside the folder you scanned can be removed, and never:

  • the scanned folder itself, your home folder, or a folder that holds it;
  • /Users on macOS, /home on Linux or C:\Users on Windows, or any account's folder in it (what is inside one can still be marked);
  • system folders (/usr, /etc, C:\Windows, Program Files, Homebrew's prefix and the like), even where permissions would allow it;
  • a mount point, or anything with another disk mounted inside it;
  • what a symlink points to (the link is removed, not its target).

Each rule is tested. The full list is in the guide. These are checked before you mark, so Mark is never offered for them.

One removal may also take only 5% of a disk by default. Past that, Mark becomes Over 5% limit with a ▾ that holds Mark anyway, and Review asks you to type what you are doing ("delete 20% of my disk") before it removes anything. Settings › Safety changes the limit, turns it off, or swaps the typing for a checkbox or nothing; agents are always held to it.

Thanks, Tobi

PwrDisk began as disktree, written by Tobi Lütke. The idea, the design and most of the code are his and disktree's contributors', and they deserve the credit.

Tobi also has a day job running Shopify, which we hear keeps him fairly busy. So we picked disktree up to keep it fed: signed installers that update themselves, macOS and Windows builds, and the AI agent link. Fixes that make sense upstream go back to disktree as pull requests.

Build it yourself

git clone https://github.com/pwrdrvr/PwrDisk
cd PwrDisk
make install

docs/building.md has what each system needs, signing your own Mac build, and how to work on the code.

License

MIT. See LICENSE and THIRD_PARTY_LICENSES.

Cache cleanup

Marked caches that PwrDisk can clean with their owner's own command (npm, npx, uv, pip, Cypress, Playwright) go to Cache cleanup in Review, or MCP's pwrdisk_removal_preview with mode: "owner_cleanup"; anything else, cache-like or not, is an ordinary removal. Check owners shows, for each marked path, the installed owner's exact command, version and whole-cache scope, or why there is none. You then choose per path: skip it, run that command, or deliberately delete the files, which has its own disclosure and its own confirmation. Missing, unsupported, failed or cancelled owner commands never fall back to deleting files. Each path gets its own result; listed allocation is separate from measured free-space change. See supported owners, versions and scope limitations.

About

Find what's eating your disk, review it, remove it. A maintained fork of tobi/disktree.

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages