Files
gpuix/disktree/README.md
T
Tommy D. Rossi 4ecca30f68 release: disktree@0.2.0
disktree now runs on plain Node (>=20). Bun is no longer required.

- ship tsc output in dist/, bin is dist/cli.js with a node shebang
- tsconfig follows the npm-package template (nodenext, rootDir src)
- worker URL follows the running file extension (.ts in src, .js in dist)
- prepublishOnly wipes dist and rebuilds
- README and AGENTS use npx disktree

Session: ses_f1b9d5d03ffep38dyOKhtgIJSt
2026-09-27 21:54:30 +02:00

1.5 KiB
Raw Permalink Blame History

disktree

See what fills your disk. A GPU-rendered treemap of any folder, built with GPUIX. A light, frosted port of tobi/disktree.

disktree scanning a website project

npx disktree            # scan the current directory
npx disktree ~/src      # or any folder
npx disktree /          # the whole disk

Runs on Node 20+ or Bun (bunx disktree). No Electron, no web view: GPUI paints it with Metal.

What it shows

  • Tiles sized by disk usage (st_blocks × 512), coloured by kind: code, agent scratch, toolchains, synced, git, media, documents, cache
  • Hatched tiles are reclaimable: caches, build output, node_modules beside a package.json, trash
  • Worth a look ranks the largest things that could go
  • Disk shows free space on the volume

Keys

Input Action
click a folder open it
click a file select it
⌫, Esc, back button up one level
[ ] change depth
t Size, Files, Age
r scan again

How it scans

A pool of up to four worker threads walks the tree with synchronous lstat, one volume only, hardlinks counted once. Each directory keeps its 12 largest files as tiles and folds the rest into one "N smaller files" tile, which keeps a full-disk scan in memory.

/System/Volumes/Data is skipped when scanning /, since it mirrors /Users and /Applications.