Linha de comando

devbroom leva o escaneamento do app para o terminal: os mesmos vereditos, os mesmos motivos. O escaneamento não apaga, não move e não altera nada; limpar é outro comando.

A linha de comando é grátis. O escaneamento só lê. devbroom clean faz o mesmo que o botão Limpar do app: mostra primeiro o que está Pronto, pergunta e depois move para a Lixeira. As proteções que você define no app também valem aqui.

Instalação

devbroom vem dentro do app; não há nada extra para instalar. Clique em “Vincular devbroom” em Ajustes › Agentes e integrações e o comando é vinculado como ~/.local/bin/devbroom. Se o app não estiver na pasta Aplicativos, mova-o para lá antes, senão o vínculo quebra. Depois abra um novo terminal e confira a versão.

Terminal

$ devbroom --versiondevbroom 0.1.0

Se ~/.local/bin não estiver no PATH do seu shell, rode o comando pelo caminho completo ou adicione essa pasta ao seu PATH.

Uso

devbroom [scan] [CAMINHO...] [opções]devbroom clean [CAMINHO...] [--dry-run] [--delete] [--include-review CAMINHO]... [--yes] [--json]devbroom status [--json]devbroom mcpdevbroom compat

Sem um caminho, é escaneada a pasta em que você está. Você pode passar vários caminhos. Os dados dos agentes na sua pasta pessoal entram em todo escaneamento.

Exemplos

$ devbroom                        # a pasta em que você está$ devbroom ~/projects ~/work      # várias pastas$ devbroom ~/projects --details   # com todos os motivos$ devbroom ~/projects --all       # todos, não só os maiores

Opções

Opção	O que faz
`-d, --details`	Mostra todos os motivos por trás de cada veredito.
`-a, --all`	Lista todos os itens encontrados, não só os maiores.
`--json`	Escreve o relatório completo em JSON.
`--no-color`	Desliga as cores. Também não há cores quando `NO_COLOR` está definida.
`-h, --help`	Mostra a ajuda.
`-V, --version`	Mostra a versão.
`--`	Trata tudo o que vem depois como caminho: `devbroom -- -odd-folder`

Uma opção desconhecida é um erro, e nada é escaneado.

Limpeza

devbroom clean escaneia, monta um plano novo a partir do que está Pronto, mostra o plano e, só depois do seu OK, move essas pastas para a Lixeira. O que ele fez aparece no Histórico do app; se uma limpeza já estiver rodando no app, ele não espera: encerra.

Terminal

$ devbroom clean ~/projects --dry-run   # só mostrar$ devbroom clean ~/projects             # mostrar, perguntar, mover para a Lixeira

Opção	O que faz
`-n, --dry-run`	Mostra o plano e não muda nada.
`--delete`	Apaga permanentemente em vez de mover para a Lixeira. Indisponível se sua organização desativou a exclusão permanente.
`--include-review CAMINHO`	Adiciona ao plano um item em Revisar; é o “Incluir mesmo assim” do app. Pede confirmação no terminal e não pode ser usada com `--yes`. Pode ser passada mais de uma vez.
`-y, --yes`	Limpa sem perguntar.
`--json`	Escreve o plano e o resultado em JSON.

Sem um caminho, ele usa as pastas que você escolheu no app, ou a pasta em que você está se o app nunca foi configurado. clean só limpa pastas de build, pastas temporárias dos agentes e caches; worktrees e dados dos agentes são limpos no app.

Quando não há terminal para perguntar, ou quando --yes é passado, ele é mais rígido: itens que só estão Prontos por causa do .devbroom.toml do próprio projeto ficam fora do plano, já que um agente poderia ter escrito esse arquivo. Sem terminal e sem --yes, nada muda.

Status

devbroom status mostra o último escaneamento do app sem escanear de novo: quanto está pronto para limpar, há quantos minutos foi escaneado e os maiores itens Prontos. --json entrega o mesmo em JSON. Se o app ainda não escaneou, é um erro.

MCP para agentes

devbroom mcp é um servidor MCP. Claude Code, Codex ou Cursor podem ler o último escaneamento, perguntar por que uma pasta está Pronta ou Bloqueada e pedir a você para limpar; o pedido chega a você no app, e ele nunca limpa nada sozinho. A configuração está na página de Integrações.

Lendo a saída

O relatório é escrito em inglês e tem quatro partes. Cada linha começa com o veredito do 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: Os agentes neste Mac: versão, espaço ocupado, número de sessões, quantas são de pastas que não existem mais e quantas estão rodando.
Cleanup potential: Tamanho total e número de itens para cada veredito.
Worktrees: A ação sugerida para cada worktree (remove, prune, repair) e o veredito dela.
Largest items: Os maiores itens, com seus motivos. --all mostra todos.

Vereditos

A linha de comando usa os quatro vereditos do app, escritos em maiúsculas (em inglês).

Na saída	O que significa
READYPronto	Passou em todas as verificações para esta ação.
REVIEWRevisar	Um risco conhecido, ou uma decisão que só você pode tomar; um arquivo `.env` ignorado, por exemplo.
BLOCKEDBloqueado	Em uso, protegido, ou com trabalho que o git se recusaria a descartar.
UNKNOWNDesconhecido	Evidências insuficientes. Nunca conta como Pronto.

Saída JSON

--json escreve o relatório completo; serve para scripts e integração contínua. O formato é versionado pelo campo schema_version, atualmente 1. Nenhuma linha de progresso é escrita quando se pede JSON.

Terminal

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

Compatibilidade

devbroom compat mostra quais versões dos agentes o Devbroom testou e quais estão instaladas no seu 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 a sua versão estiver fora da faixa testada, mas os arquivos do agente estiverem no formato esperado, o Devbroom funciona e a mostra como “ainda não testada”. Se o formato não se mantiver, os dados desse agente são só lidos; nada deles conta como pronto para limpar.

Códigos de saída

Código	Significado
`0`	Concluído.
`1`	Falhou.
`2`	Uso incorreto: uma opção desconhecida ou um caminho que não é uma pasta.
`3`	`clean`: não confirmado, nada mudou.
`4`	`clean`: concluído em parte.
`5`	`clean`: outra limpeza está rodando.
`6`	`clean`: a política da sua organização não permite.
`130`	Cancelado (Ctrl-C).

Ctrl-C para o escaneamento; um segundo Ctrl-C encerra na hora.

Variáveis de ambiente

Variável	Efeito
`NO_COLOR`	Quando definida, a saída não tem cores.
`CLAUDE_CONFIG_DIR`	Se a pasta de ajustes do Claude Code está em outro lugar que não `~/.claude`, ela é lida de lá.
`CLAUDE_CODE_TMPDIR`	Se você moveu a pasta temporária do Claude Code, ela é lida de lá.
`CODEX_HOME`	Se a pasta do Codex está em outro lugar que não `~/.codex`, ela é lida de lá.
`CURSOR_CONFIG_DIR`	Se a pasta do Cursor está em outro lugar que não `~/.cursor`, ela é lida de lá.
`XDG_DATA_HOME`, `XDG_CACHE_HOME`, `OPENCODE_DB`	Se os dados e o banco de dados do OpenCode estão em outro lugar, são lidos de lá.

AnteriorRegras PróximaIntegrações

Última atualização: 7 de outubro de 2026