Ligne de commande

devbroom apporte l'analyse de l'app dans le Terminal : les mêmes verdicts, les mêmes raisons. L'analyse ne supprime, ne déplace et ne modifie rien ; le nettoyage est une commande à part.

La ligne de commande est gratuite. L'analyse ne fait que lire. devbroom clean fait ce que fait le bouton Nettoyer de l'app : il montre d'abord ce qui est Prêt, demande, puis le place dans la Corbeille. Les protections définies dans l'app s'appliquent ici aussi.

Installation

devbroom est inclus dans l'app ; rien de plus à installer. Appuyez sur « Lier devbroom » dans Réglages › Agents et intégrations et la commande est liée en tant que ~/.local/bin/devbroom. Si l'app n'est pas dans le dossier Applications, déplacez-la d'abord, sinon le lien se casse. Ouvrez ensuite un nouveau terminal et vérifiez la version.

Terminal

$ devbroom --versiondevbroom 0.1.0

Si ~/.local/bin n'est pas dans le PATH de votre shell, lancez la commande avec son chemin complet ou ajoutez ce dossier à votre PATH.

Utilisation

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

Sans chemin, c'est le dossier où vous êtes qui est analysé. Vous pouvez indiquer plusieurs chemins. Les données des agents dans votre dossier personnel font partie de chaque analyse.

Exemples

$ devbroom                        # le dossier où vous êtes$ devbroom ~/projects ~/work      # plusieurs dossiers$ devbroom ~/projects --details   # avec toutes les raisons$ devbroom ~/projects --all       # tout, pas seulement les plus gros

Options

Option	Effet
`-d, --details`	Affiche toutes les raisons derrière chaque verdict.
`-a, --all`	Liste tous les éléments trouvés, pas seulement les plus gros.
`--json`	Écrit tout le rapport en JSON.
`--no-color`	Désactive les couleurs. Aucune couleur n'est utilisée non plus quand `NO_COLOR` est défini.
`-h, --help`	Affiche l'aide.
`-V, --version`	Affiche la version.
`--`	Traite tout ce qui suit comme un chemin : `devbroom -- -odd-folder`

Une option inconnue est une erreur, et rien n'est analysé.

Nettoyage

devbroom clean analyse, établit un nouveau plan à partir de ce qui est Prêt, affiche ce plan, et ne place ces dossiers dans la Corbeille qu'après votre accord. Ce qu'il a fait apparaît dans l'Historique de l'app ; si un nettoyage est déjà en cours dans l'app, il n'attend pas, il s'arrête.

Terminal

$ devbroom clean ~/projects --dry-run   # afficher seulement$ devbroom clean ~/projects             # afficher, demander, placer dans la Corbeille

Option	Effet
`-n, --dry-run`	Affiche le plan sans rien modifier.
`--delete`	Supprime définitivement au lieu de placer dans la Corbeille. Indisponible si votre organisation a désactivé la suppression définitive.
`--include-review PATH`	Ajoute un élément À vérifier au plan ; c'est le « Inclure quand même » de l'app. Demande une confirmation dans le terminal et ne peut pas être utilisé avec `--yes`. Peut être indiqué plusieurs fois.
`-y, --yes`	Nettoie sans demander.
`--json`	Écrit le plan et le résultat en JSON.

Sans chemin, il utilise les dossiers choisis dans l'app, ou le dossier où vous êtes si l'app n'a jamais été configurée. clean ne nettoie que les dossiers de build, les dossiers temporaires des agents et les caches ; les worktrees et les données des agents se nettoient dans l'app.

Quand il n'y a pas de terminal pour poser la question, ou que --yes est indiqué, il est plus strict : les éléments qui ne sont Prêts qu'en raison du .devbroom.toml propre à un projet restent hors du plan, car un agent aurait pu écrire ce fichier. Sans terminal et sans --yes, rien ne change.

État

devbroom status affiche la dernière analyse de l'app sans analyser à nouveau : combien est prêt à nettoyer, il y a combien de minutes l'analyse a eu lieu et les plus gros éléments Prêts. --json fournit la même chose en JSON. Si l'app n'a encore rien analysé, c'est une erreur.

MCP pour les agents

devbroom mcp est un serveur MCP. Claude Code, Codex ou Cursor peuvent lire la dernière analyse, demander pourquoi un dossier est Prêt ou Bloqué, et vous demander de nettoyer ; la demande vous parvient dans l'app, et il ne nettoie jamais rien de lui-même. La configuration est sur la page Intégrations.

Lire la sortie

Le rapport est rédigé en anglais et comporte quatre parties. Chaque ligne commence par le verdict de l'élément.

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: Les agents présents sur ce Mac : version, espace occupé, nombre de sessions, combien concernent des dossiers qui n'existent plus et combien sont en cours.
Cleanup potential: Taille totale et nombre d'éléments pour chaque verdict.
Worktrees: L'action suggérée pour chaque worktree (remove, prune, repair) et son verdict.
Largest items: Les plus gros éléments, avec leurs raisons. --all les affiche tous.

Verdicts

La ligne de commande utilise les quatre verdicts de l'app, écrits en majuscules.

Dans la sortie	Signification
READYPrêt	Toutes les vérifications sont passées pour cette action.
REVIEWÀ vérifier	Un risque connu, ou une décision que vous seul pouvez prendre ; un fichier `.env` ignoré, par exemple.
BLOCKEDBloqué	Utilisé, protégé, ou contient du travail que git refuserait de jeter.
UNKNOWNInconnu	Pas assez d'éléments. Jamais compté comme Prêt.

Sortie JSON

--json écrit tout le rapport ; il convient aux scripts et à l'intégration continue. Le format est versionné par le champ schema_version, actuellement 1. Aucune ligne de progression n'est écrite quand le JSON est demandé.

Terminal

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

Compatibilité

devbroom compat indique quelles versions d'agents Devbroom a testées et lesquelles sont installées sur votre Mac.

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

Si votre version est hors de la plage testée mais que les fichiers de l'agent sont au format attendu, Devbroom fonctionne et l'affiche comme « pas encore testée ». Si le format ne tient pas, les données de cet agent sont seulement lues ; aucune n'est considérée comme prête à nettoyer.

Codes de sortie

Code	Signification
`0`	Terminé.
`1`	Échec.
`2`	Mauvaise utilisation : une option inconnue ou un chemin qui n'est pas un dossier.
`3`	`clean` : non confirmé, rien n'a changé.
`4`	`clean` : effectué en partie.
`5`	`clean` : un autre nettoyage est en cours.
`6`	`clean` : la politique de votre organisation ne l'autorise pas.
`130`	Annulé (Ctrl-C).

Ctrl-C arrête l'analyse ; un second Ctrl-C quitte immédiatement.

Variables d'environnement

Variable	Effet
`NO_COLOR`	Si elle est définie, la sortie n'a pas de couleurs.
`CLAUDE_CONFIG_DIR`	Si le dossier de réglages de Claude Code n'est pas `~/.claude`, il est lu à cet endroit.
`CLAUDE_CODE_TMPDIR`	Si vous avez déplacé le dossier temporaire de Claude Code, il est lu à cet endroit.
`CODEX_HOME`	Si le dossier de Codex n'est pas `~/.codex`, il est lu à cet endroit.
`CURSOR_CONFIG_DIR`	Si le dossier de Cursor n'est pas `~/.cursor`, il est lu à cet endroit.
`XDG_DATA_HOME`, `XDG_CACHE_HOME`, `OPENCODE_DB`	Si les données et la base de données d'OpenCode sont ailleurs, elles sont lues à cet endroit.

PrécédentRègles SuivantIntégrations

Dernière mise à jour : 7 octobre 2026