Getting started

Setup takes a few minutes. The first scan only reads; it shows what it found and why it decided what it did, and touches nothing until you confirm.

Devbroom runs on Macs with Apple Silicon chips, on macOS 13.3 or later.

Download and install

Download the .dmg from the Download page, open it and drag Devbroom to the Applications folder. Open the app from there.

Devbroom looks for new versions by itself: once, 8 seconds after launch, it reads the latest.json file we publish. If there's a new version it asks you; say “Install” and its signature is checked before it's installed. Nothing about you is sent; details on the Privacy page.

Pick your folders

On first launch Devbroom asks where your projects live. Choose the folders that hold your code, or drag them in; you can add and remove them later in Settings › Folders.

You don't need to add the agents' own folders. The agent folders in your home folder (~/.claude, ~/.codex and the others) are part of every scan.

Full Disk Access

If a folder macOS protects, such as Desktop, Documents or Downloads, can't be read, Devbroom tells you: “1 folder needs Full Disk Access.” Its button takes you to System Settings › Privacy & Security › Full Disk Access, where you turn Devbroom on. This permission is optional: without it Devbroom just can't read those folders.

The first scan

The scan starts once you've picked your folders. It only reads: it finds git repositories and worktrees, the agents' folders, build output and developer caches, measures how much space each one really takes on disk, and checks which agents are still running.

Reading the bubbles

On the Storage screen everything found is a bubble, as big as the space it takes. Each bubble gets its verdict and joins its pile:

Pile What it means
READYReady Every check passed. It's selected for cleaning from the start.
REVIEWReview Worth a look first. It's cleaned only if you choose “Include anyway”.
BLOCKEDBlocked In use or holding work. Can't be selected.
UNKNOWNUnknown Not enough evidence. Can't be selected, never counted as Ready.

Click a bubble to see the reasons behind its verdict: which agent it belongs to, whether it's in use, whether it holds unsaved work. Look inside shows you the folder's contents. All verdicts are on the Verdicts page.

Cleaning

  1. Press Clean. Devbroom checks the selected items again right away: “Checking 27 items again.”
  2. The preview shows what will happen: “Move 27 items to Trash”, the total size and each item. Anything you picked that didn't pass the check is listed under “Left out” with the reason.
  3. Confirm and the items move to the Trash. If something changed since the scan, it's left alone and you're told why it was skipped.
  4. Space moved to the Trash stays on disk until you empty the Trash; Devbroom says so: “moved to Trash · space returns when you empty it”.

If you change your mind, Put back returns everything; later you can still put items back one by one from History. Deleting permanently is a separate choice, confirmed by holding its button.

Worktrees don't go to the Trash: they're removed with git, their HEAD is first saved to a recovery ref, and their branch stays.

Automatic upkeep

In Settings › Automatic upkeep you choose when Devbroom scans by itself (off, daily or weekly) and how many GB should be ready before it lets you know. Automatic scans only read.

You can also add rules, such as “build folders older than 90 days”. A rule asks you first by default. Choose “Do it by itself” and it moves only Ready items, and only to the Trash; each one can be put back. Unless you turn these on, Devbroom changes nothing without your OK. Automatic upkeep comes with Pro.

Sessions

The Sessions tab shows your agents' session history by folder: which ones are running, how much space they take, the ones whose folders no longer exist, and the estimated value of the tokens used at API list prices, including the last 30 days. These numbers are worked out only on your Mac.

  • Search: searches what was said in your sessions. The logs are read at that moment, nothing is indexed; strings that look like secrets are hidden in the results.
  • Archive conversations: packs a folder's Claude Code conversations into an archive, verifies it, then moves the originals to the Trash. The project's memory stays in place. claude --resume can't open archived conversations until they're reopened; you can reopen them from History.

Usage and cost, search and archive come with Pro.

Devbroom also lives in the menu bar: it shows how much was ready after the last scan and, while a scan runs, its progress; from there you can scan again or stop the scan. Close the window and Devbroom leaves the Dock and keeps running in the menu bar; to quit completely, press ⌘Q.

Pro

Scanning, verdicts, cleaning, putting back, the command line and MCP are free. Automatic upkeep, Analytics and the session tools are in Pro. For the first 14 days all of Pro is on; no card, account or email needed. When the trial ends nothing is deleted: your rules pause and your history stays. Pro is a one-time $29 for 2 Macs; details on the Pricing page.

NextVerdicts

Last updated: October 7, 2026