Kommandozeile

devbroom bringt den Scan der App ins Terminal: dieselben Einstufungen, dieselben Begründungen. Der Scan löscht, verschiebt und ändert nichts; Aufräumen ist ein eigener Befehl.

Die Kommandozeile ist kostenlos. Der Scan liest nur. devbroom clean tut, was die Taste Aufräumen in der App tut: Es zeigt zuerst, was Bereit ist, fragt und legt es dann in den Papierkorb. Die Schutzregeln, die Sie in der App festlegen, gelten auch hier.

Einrichtung

devbroom steckt in der App; es gibt nichts extra zu installieren. Klicken Sie in Einstellungen › Agenten und Integrationen auf „devbroom verknüpfen“, und der Befehl wird als ~/.local/bin/devbroom verlinkt. Liegt die App nicht im Ordner Programme, verschieben Sie sie zuerst dorthin, sonst geht die Verknüpfung kaputt. Öffnen Sie dann ein neues Terminal und prüfen Sie die Version.

Terminal

$ devbroom --versiondevbroom 0.1.0

Ist ~/.local/bin nicht im PATH Ihrer Shell, rufen Sie den Befehl mit vollem Pfad auf oder fügen Sie diesen Ordner zu Ihrem PATH hinzu.

Verwendung

devbroom [scan] [PATH...] [options]devbroom clean [PATH...] [--dry-run] [--delete] [--include-review PATH]... [--yes] [--json]devbroom status [--json]devbroom mcpdevbroom compat

Ohne Pfad wird der aktuelle Ordner gescannt. Sie können mehrere Pfade angeben. Die Daten der Agenten in Ihrem Benutzerordner gehören zu jedem Scan.

Beispiele

$ devbroom                        # der aktuelle Ordner$ devbroom ~/projects ~/work      # mehrere Ordner$ devbroom ~/projects --details   # mit allen Begründungen$ devbroom ~/projects --all       # alle, nicht nur die größten

Optionen

Option	Was sie tut
`-d, --details`	Zeigt alle Begründungen hinter jeder Einstufung.
`-a, --all`	Listet alle gefundenen Objekte auf, nicht nur die größten.
`--json`	Schreibt den ganzen Bericht als JSON.
`--no-color`	Schaltet Farben ab. Auch wenn `NO_COLOR` gesetzt ist, werden keine Farben verwendet.
`-h, --help`	Zeigt die Hilfe.
`-V, --version`	Zeigt die Version.
`--`	Behandelt alles danach als Pfad: `devbroom -- -odd-folder`

Eine unbekannte Option ist ein Fehler, und es wird nichts gescannt.

Aufräumen

devbroom clean scannt, erstellt aus allem, was Bereit ist, einen frischen Plan, zeigt ihn und legt diese Ordner erst nach Ihrem OK in den Papierkorb. Was es getan hat, erscheint im Verlauf der App; läuft in der App bereits ein Aufräumvorgang, wartet es nicht, sondern beendet sich.

Terminal

$ devbroom clean ~/projects --dry-run   # nur anzeigen$ devbroom clean ~/projects             # anzeigen, fragen, in den Papierkorb legen

Option	Was sie tut
`-n, --dry-run`	Zeigt den Plan und ändert nichts.
`--delete`	Löscht endgültig, statt in den Papierkorb zu legen. Nicht verfügbar, wenn Ihre Organisation endgültiges Löschen abgeschaltet hat.
`--include-review PATH`	Nimmt ein Objekt mit Prüfen in den Plan auf; entspricht „Trotzdem einbeziehen“ in der App. Fragt im Terminal nach Bestätigung und lässt sich nicht mit `--yes` kombinieren. Kann mehrfach angegeben werden.
`-y, --yes`	Räumt auf, ohne zu fragen.
`--json`	Schreibt Plan und Ergebnis als JSON.

Ohne Pfad verwendet es die Ordner, die Sie in der App gewählt haben, oder den aktuellen Ordner, falls die App nie eingerichtet wurde. clean räumt nur Build-Ordner, temporäre Ordner der Agenten und Caches auf; Worktrees und Agentendaten werden in der App aufgeräumt.

Gibt es kein Terminal zum Nachfragen oder ist --yes angegeben, ist es strenger: Objekte, die nur wegen der projekteigenen .devbroom.toml Bereit sind, bleiben aus dem Plan, da auch ein Agent diese Datei geschrieben haben könnte. Ohne Terminal und ohne --yes ändert sich nichts.

Status

devbroom status zeigt den letzten Scan der App, ohne neu zu scannen: wie viel bereit zum Aufräumen ist, vor wie vielen Minuten gescannt wurde und die größten bereiten Objekte. --json liefert dasselbe als JSON. Hat die App noch nicht gescannt, ist das ein Fehler.

MCP für Agenten

devbroom mcp ist ein MCP-Server. Claude Code, Codex oder Cursor können den letzten Scan lesen, fragen, warum ein Ordner Bereit oder Gesperrt ist, und Sie ums Aufräumen bitten; die Anfrage landet bei Ihnen in der App, und von selbst räumt es nie etwas auf. Die Einrichtung steht auf der Seite Integrationen.

Die Ausgabe lesen

Der Bericht ist auf Englisch und hat vier Teile. Jede Zeile beginnt mit der Einstufung des Objekts.

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: Die Agenten auf diesem Mac: Version, belegter Platz, Anzahl der Sitzungen, wie viele davon zu Ordnern gehören, die es nicht mehr gibt, und wie viele laufen.
Cleanup potential: Gesamtgröße und Anzahl der Objekte für jede Einstufung.
Worktrees: Die vorgeschlagene Aktion für jeden Worktree (remove, prune, repair) und seine Einstufung.
Largest items: Die größten Objekte mit ihren Begründungen. --all zeigt alle.

Einstufungen

Die Kommandozeile verwendet die vier Einstufungen der App, in Großbuchstaben und auf Englisch.

In der Ausgabe	Bedeutung
READYBereit	Alle Prüfungen für diese Aktion bestanden.
REVIEWPrüfen	Ein bekanntes Risiko oder eine Entscheidung, die nur Sie treffen können; zum Beispiel eine ignorierte `.env`-Datei.
BLOCKEDGesperrt	In Benutzung, geschützt oder mit Arbeit darin, die git nicht verwerfen würde.
UNKNOWNUnbekannt	Zu wenig Belege. Zählt nie als Bereit.

JSON-Ausgabe

--json schreibt den ganzen Bericht; das eignet sich für Skripte und Continuous Integration. Das Format ist über das Feld schema_version versioniert, derzeit 1. Wird JSON angefordert, wird keine Fortschrittszeile ausgegeben.

Terminal

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

Kompatibilität

devbroom compat zeigt, welche Agentenversionen Devbroom getestet hat und welche auf Ihrem Mac installiert sind.

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

Liegt Ihre Version außerhalb des getesteten Bereichs, die Dateien des Agenten haben aber das erwartete Format, funktioniert Devbroom und zeigt sie als „noch nicht getestet“ an. Stimmt das Format nicht, werden die Daten dieses Agenten nur gelesen; nichts davon gilt als bereit zum Aufräumen.

Exit-Codes

Code	Bedeutung
`0`	Erledigt.
`1`	Fehlgeschlagen.
`2`	Falsche Verwendung: eine unbekannte Option oder ein Pfad, der kein Ordner ist.
`3`	`clean`: nicht bestätigt, nichts geändert.
`4`	`clean`: teilweise erledigt.
`5`	`clean`: ein anderer Aufräumvorgang läuft.
`6`	`clean`: die Richtlinie Ihrer Organisation erlaubt es nicht.
`130`	Abgebrochen (Ctrl-C).

Ctrl-C stoppt den Scan; ein zweites Ctrl-C beendet sofort.

Umgebungsvariablen

Variable	Wirkung
`NO_COLOR`	Wenn gesetzt, hat die Ausgabe keine Farben.
`CLAUDE_CONFIG_DIR`	Liegt der Einstellungsordner von Claude Code nicht unter `~/.claude`, wird er von dort gelesen.
`CLAUDE_CODE_TMPDIR`	Haben Sie den temporären Ordner von Claude Code verlegt, wird er von dort gelesen.
`CODEX_HOME`	Liegt der Ordner von Codex nicht unter `~/.codex`, wird er von dort gelesen.
`CURSOR_CONFIG_DIR`	Liegt der Ordner von Cursor nicht unter `~/.cursor`, wird er von dort gelesen.
`XDG_DATA_HOME`, `XDG_CACHE_HOME`, `OPENCODE_DB`	Liegen Daten und Datenbank von OpenCode woanders, werden sie von dort gelesen.

ZurückRegeln WeiterIntegrationen

Zuletzt aktualisiert: 7. Oktober 2026