Opdrachtregel

devbroom brengt de scan van de app naar de terminal: dezelfde oordelen, dezelfde redenen. Scannen verwijdert, verplaatst en verandert niets; opruimen is een aparte opdracht.

De opdrachtregel is gratis. Scannen leest alleen. devbroom clean doet wat de knop Opruimen in de app doet: het laat eerst zien wat Klaar is, vraagt het je en verplaatst het daarna naar de Prullenmand. De beschermingen die je in de app instelt, gelden hier ook.

Installatie

devbroom zit in de app; je hoeft niets extra te installeren. Druk op “Koppel devbroom” in Instellingen › Agents en integraties en de opdracht wordt gekoppeld als ~/.local/bin/devbroom. Als de app niet in de map Apps staat, zet hem daar dan eerst neer, anders werkt de koppeling niet meer. Open daarna een nieuwe terminal en controleer de versie.

Terminal
$ devbroom --versiondevbroom 0.1.0

Als ~/.local/bin niet in het PATH van je shell staat, voer de opdracht dan uit met het volledige pad of voeg die map toe aan je PATH.

Gebruik

Gebruik
devbroom [scan] [PAD...] [opties]devbroom clean [PAD...] [--dry-run] [--delete] [--include-review PAD]... [--yes] [--json]devbroom status [--json]devbroom mcpdevbroom compat

Zonder pad wordt de map gescand waarin je staat. Je kunt meerdere paden opgeven. De data van de agents in je thuismap hoort bij elke scan.

Voorbeelden
$ devbroom                        # de map waarin je staat$ devbroom ~/projects ~/work      # meerdere mappen$ devbroom ~/projects --details   # met elke reden$ devbroom ~/projects --all       # alles, niet alleen de grootste

Opties

Optie Wat het doet
-d, --details Toont elke reden achter elk oordeel.
-a, --all Toont elk gevonden item, niet alleen de grootste.
--json Schrijft het hele rapport als JSON.
--no-color Zet kleuren uit. Er worden ook geen kleuren gebruikt als NO_COLOR is ingesteld.
-h, --help Toont de hulp.
-V, --version Toont de versie.
-- Behandelt alles erna als pad: devbroom -- -odd-folder

Een onbekende optie is een fout, en dan wordt er niets gescand.

Opruimen

devbroom clean scant, maakt een vers plan van wat Klaar is, toont het plan en verplaatst die mappen pas na jouw akkoord naar de Prullenmand. Wat het deed, verschijnt in de Geschiedenis van de app; als er in de app al een opruimactie loopt, wacht het niet maar stopt het.

Terminal
$ devbroom clean ~/projects --dry-run   # alleen tonen$ devbroom clean ~/projects             # tonen, vragen, naar de Prullenmand
Optie Wat het doet
-n, --dry-run Toont het plan en verandert niets.
--delete Verwijdert definitief in plaats van naar de Prullenmand te verplaatsen. Niet beschikbaar als je organisatie definitief verwijderen heeft uitgezet.
--include-review PAD Voegt een item met Nakijken toe aan het plan; het “Toch meenemen” van de app. Vraagt om bevestiging in de terminal en kan niet samen met --yes worden gebruikt. Kan meer dan eens worden opgegeven.
-y, --yes Ruimt op zonder te vragen.
--json Schrijft het plan en het resultaat als JSON.

Zonder pad gebruikt het de mappen die je in de app koos, of de map waarin je staat als de app nooit is ingesteld. clean ruimt alleen buildmappen, tijdelijke mappen van agents en caches op; worktrees en data van agents worden in de app opgeruimd.

Als er geen terminal is om in te vragen, of als --yes is opgegeven, is het strenger: items die alleen Klaar zijn door het eigen .devbroom.toml van een project blijven buiten het plan, omdat een agent dat bestand geschreven kan hebben. Zonder terminal en zonder --yes verandert er niets.

Status

devbroom status toont de laatste scan van de app zonder opnieuw te scannen: hoeveel er klaar is om op te ruimen, hoeveel minuten geleden er is gescand en de grootste items met Klaar. --json geeft hetzelfde als JSON. Als de app nog niet heeft gescand, is het een fout.

MCP voor agents

devbroom mcp is een MCP-server. Claude Code, Codex of Cursor kunnen de laatste scan lezen, vragen waarom een map Klaar of Geblokkeerd is en jou vragen op te ruimen; het verzoek komt bij jou in de app, en het ruimt nooit zelf iets op. De installatie staat op de pagina Integraties.

De uitvoer lezen

Het rapport is in het Engels en heeft vier delen. Elke regel begint met het oordeel over het item.

devbroom ~/projects
$ devbroom ~/projectsDevbroom scan (read-only) ~/projects in 22.4sAgent data on this Mac  Claude Code 2.1.288   37.8 GB  297 sessions, 2 running  Codex 0.159.2          746 MB  41 sessions  Orca 1.4.215           528 MBCleanup potential  READY    19.7 GB  56 items  every check passed  REVIEW   16.9 GB  39 items  worth a look before cleaning  BLOCKED  19.1 GB   5 items  in use or holding work
Agent data on this Mac
De agents op deze Mac: versie, ingenomen ruimte, aantal sessies, hoeveel daarvan voor mappen die niet meer bestaan en hoeveel er actief zijn.
Cleanup potential
Totale grootte en aantal items per oordeel.
Worktrees
De voorgestelde actie voor elke worktree (remove, prune, repair) en het oordeel.
Largest items
De grootste items, met hun redenen. --all toont ze allemaal.

Oordelen

De opdrachtregel gebruikt de vier oordelen van de app, in hoofdletters.

In de uitvoer Wat het betekent
READYKlaar Alle controles voor deze actie zijn geslaagd.
REVIEWNakijken Een bekend risico, of een keuze die alleen jij kunt maken; een genegeerd .env-bestand, bijvoorbeeld.
BLOCKEDGeblokkeerd In gebruik, beschermd, of bevat werk dat git zou weigeren weg te gooien.
UNKNOWNOnbekend Te weinig bewijs. Telt nooit als Klaar.

JSON-uitvoer

--json schrijft het hele rapport; handig voor scripts en continuous integration. Het formaat heeft een versie in het veld schema_version, nu 1. Als om JSON wordt gevraagd, wordt er geen voortgangsregel geschreven.

Terminal
$ devbroom ~/projects --json > rapport.json$ head -3 rapport.json{  "schema_version": 1,  …

Compatibiliteit

devbroom compat laat zien welke versies van agents Devbroom heeft getest en welke op je Mac staan.

devbroom compat
Claude Code  tested: 2.1.0 to 2.1.292     here: 2.1.288 · verifiedCodex        tested: 0.115.0 to 0.159.2   here: 0.159.2 · verifiedCursor       tested: none yet             here: not on this MacOpenCode     tested: none yet             here: not on this MacOrca         tested: 1.4.0 to 1.4.221     here: 1.4.215 · verified

Als je versie buiten het geteste bereik valt maar de bestanden van de agent het verwachte formaat hebben, werkt Devbroom en toont het hem als “nog niet getest”. Klopt het formaat niet, dan wordt de data van die agent alleen gelezen; niets ervan telt als klaar om op te ruimen.

Exitcodes

Code Betekenis
0 Klaar.
1 Mislukt.
2 Verkeerd gebruik: een onbekende optie of een pad dat geen map is.
3 clean: niet bevestigd, niets veranderd.
4 clean: deels uitgevoerd.
5 clean: er loopt al een andere opruimactie.
6 clean: het beleid van je organisatie staat het niet toe.
130 Geannuleerd (Ctrl-C).

Ctrl-C stopt de scan; een tweede Ctrl-C sluit meteen af.

Omgevingsvariabelen

Variabele Effect
NO_COLOR Als deze is ingesteld, heeft de uitvoer geen kleuren.
CLAUDE_CONFIG_DIR Als de instellingenmap van Claude Code ergens anders staat dan ~/.claude, wordt die daar gelezen.
CLAUDE_CODE_TMPDIR Als je de tijdelijke map van Claude Code hebt verplaatst, wordt die daar gelezen.
CODEX_HOME Als de map van Codex ergens anders staat dan ~/.codex, wordt die daar gelezen.
CURSOR_CONFIG_DIR Als de map van Cursor ergens anders staat dan ~/.cursor, wordt die daar gelezen.
XDG_DATA_HOME, XDG_CACHE_HOME, OPENCODE_DB Als de data en database van OpenCode ergens anders staan, worden ze daar gelezen.
VorigeRegels VolgendeIntegraties

Laatst bijgewerkt: 7 oktober 2026