Riga di comando

devbroom porta nel terminale la scansione dell'app: gli stessi verdetti, gli stessi motivi. La scansione non elimina, non sposta e non modifica nulla; la pulizia è un comando a parte.

La riga di comando è gratuita. La scansione legge soltanto. devbroom clean fa ciò che fa il pulsante Pulisci dell'app: prima mostra ciò che è Pronto, chiede, poi lo sposta nel Cestino. Le protezioni che imposti nell'app valgono anche qui.

Configurazione

devbroom è incluso nell'app; non c'è altro da installare. Premi “Collega devbroom” in Impostazioni › Agenti e integrazioni e il comando viene collegato come ~/.local/bin/devbroom. Se l'app non è nella cartella Applicazioni, spostala lì prima, altrimenti il collegamento si interrompe. Poi apri un nuovo terminale e controlla la versione.

Terminale

$ devbroom --versiondevbroom 0.1.0

Se ~/.local/bin non è nel PATH della tua shell, esegui il comando con il percorso completo o aggiungi quella cartella al tuo PATH.

Uso

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

Senza un percorso viene scansionata la cartella in cui ti trovi. Puoi indicare più percorsi. I dati degli agenti nella tua cartella Inizio fanno parte di ogni scansione.

Esempi

$ devbroom                        # la cartella in cui ti trovi$ devbroom ~/projects ~/work      # più cartelle$ devbroom ~/projects --details   # con tutti i motivi$ devbroom ~/projects --all       # tutti, non solo i più grandi

Opzioni

Opzione	Cosa fa
`-d, --details`	Mostra tutti i motivi dietro ogni verdetto.
`-a, --all`	Elenca tutti gli elementi trovati, non solo i più grandi.
`--json`	Scrive l'intero report in JSON.
`--no-color`	Disattiva i colori. I colori non vengono usati nemmeno quando è impostato `NO_COLOR`.
`-h, --help`	Mostra l'aiuto.
`-V, --version`	Mostra la versione.
`--`	Tratta tutto ciò che segue come un percorso: `devbroom -- -odd-folder`

Un'opzione sconosciuta è un errore, e non viene scansionato nulla.

Pulizia

devbroom clean esegue la scansione, prepara un nuovo piano con ciò che è Pronto, mostra il piano e solo dopo il tuo consenso sposta quelle cartelle nel Cestino. Ciò che ha fatto compare nella Cronologia dell'app; se nell'app è già in corso una pulizia non aspetta, esce.

Terminale

$ devbroom clean ~/projects --dry-run   # mostra soltanto$ devbroom clean ~/projects             # mostra, chiedi, sposta nel Cestino

Opzione	Cosa fa
`-n, --dry-run`	Mostra il piano e non cambia nulla.
`--delete`	Elimina definitivamente invece di spostare nel Cestino. Non disponibile se la tua organizzazione ha disattivato l'eliminazione definitiva.
`--include-review PERCORSO`	Aggiunge al piano un elemento Da verificare; è l'equivalente di “Includi comunque” nell'app. Chiede conferma nel terminale e non si può usare con `--yes`. Si può indicare più volte.
`-y, --yes`	Pulisce senza chiedere.
`--json`	Scrive il piano e il risultato in JSON.

Senza un percorso usa le cartelle che hai scelto nell'app, oppure la cartella in cui ti trovi se l'app non è mai stata configurata. clean pulisce solo cartelle di build, cartelle temporanee degli agenti e cache; worktree e dati degli agenti si puliscono nell'app.

Quando non c'è un terminale in cui chiedere, o quando è indicato --yes, è più rigoroso: gli elementi che sono Pronti solo grazie al .devbroom.toml di un progetto restano fuori dal piano, perché quel file potrebbe averlo scritto un agente. Senza terminale e senza --yes, non cambia nulla.

Stato

devbroom status mostra l'ultima scansione dell'app senza scansionare di nuovo: quanto è pronto da pulire, quanti minuti fa è stata eseguita la scansione e gli elementi Pronti più grandi. --json restituisce lo stesso in JSON. Se l'app non ha ancora eseguito una scansione, è un errore.

MCP per gli agenti

devbroom mcp è un server MCP. Claude Code, Codex o Cursor possono leggere l'ultima scansione, chiedere perché una cartella è Pronta o Bloccata e chiederti di pulire; la richiesta arriva a te nell'app, e non pulisce mai nulla da solo. La configurazione è nella pagina Integrazioni.

Leggere l'output

Il report è scritto in inglese e ha quattro parti. Ogni riga inizia con il verdetto dell'elemento.

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: Gli agenti su questo Mac: versione, spazio occupato, numero di sessioni, quante riguardano cartelle che non esistono più e quante sono in esecuzione.
Cleanup potential: Dimensione totale e numero di elementi per ogni verdetto.
Worktrees: L'azione suggerita per ogni worktree (remove, prune, repair) e il suo verdetto.
Largest items: Gli elementi più grandi, con i loro motivi. --all li mostra tutti.

Verdetti

La riga di comando usa i quattro verdetti dell'app, scritti in maiuscolo e in inglese.

Nell'output	Cosa significa
READYPronto	Tutti i controlli superati per questa azione.
REVIEWDa verificare	Un rischio noto, o una decisione che spetta solo a te; per esempio un file `.env` ignorato.
BLOCKEDBloccato	In uso, protetto, o contiene lavoro che git si rifiuterebbe di buttare via.
UNKNOWNSconosciuto	Prove insufficienti. Mai considerato Pronto.

Output JSON

--json scrive l'intero report; è adatto a script e integrazione continua. Il formato ha una versione indicata dal campo schema_version, attualmente 1. Quando si chiede JSON non viene scritta alcuna riga di avanzamento.

Terminale

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

Compatibilità

devbroom compat mostra quali versioni degli agenti Devbroom ha testato e quali sono installate sul tuo 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

Se la tua versione è fuori dall'intervallo testato ma i file dell'agente sono nel formato previsto, Devbroom funziona e la mostra come “non ancora testata”. Se il formato non regge, i dati di quell'agente vengono solo letti; nessuno di essi è considerato pronto da pulire.

Codici di uscita

Codice	Significato
`0`	Fatto.
`1`	Non riuscito.
`2`	Uso errato: un'opzione sconosciuta o un percorso che non è una cartella.
`3`	`clean`: non confermato, nulla è cambiato.
`4`	`clean`: completato in parte.
`5`	`clean`: è in corso un'altra pulizia.
`6`	`clean`: la policy della tua organizzazione non lo consente.
`130`	Annullato (Ctrl-C).

Ctrl-C interrompe la scansione; un secondo Ctrl-C esce subito.

Variabili d'ambiente

Variabile	Effetto
`NO_COLOR`	Se impostata, l'output non ha colori.
`CLAUDE_CONFIG_DIR`	Se la cartella delle impostazioni di Claude Code non è `~/.claude`, viene letta da lì.
`CLAUDE_CODE_TMPDIR`	Se hai spostato la cartella temporanea di Claude Code, viene letta da lì.
`CODEX_HOME`	Se la cartella di Codex non è `~/.codex`, viene letta da lì.
`CURSOR_CONFIG_DIR`	Se la cartella di Cursor non è `~/.cursor`, viene letta da lì.
`XDG_DATA_HOME`, `XDG_CACHE_HOME`, `OPENCODE_DB`	Se i dati e il database di OpenCode si trovano altrove, vengono letti da lì.

PrecedenteRegole SuccessivoIntegrazioni

Ultimo aggiornamento: 7 ottobre 2026