Primeiros passos

A instalação leva poucos minutos. O primeiro escaneamento só lê; ele mostra o que encontrou e por que decidiu o que decidiu, e não toca em nada até você confirmar.

O Devbroom roda em Macs com chips Apple Silicon, no macOS 13.3 ou posterior.

Baixar e instalar

Baixe o .dmg na página de Download, abra-o e arraste o Devbroom para a pasta Aplicativos. Abra o app de lá.

O Devbroom procura novas versões sozinho: uma vez, 8 segundos depois de abrir, ele lê o arquivo latest.json que publicamos. Se houver uma nova versão, ele pergunta; escolha “Instalar” e a assinatura é verificada antes da instalação. Nada sobre você é enviado; detalhes na página de Privacidade.

Escolha suas pastas

Na primeira vez que abre, o Devbroom pergunta onde ficam seus projetos. Escolha as pastas que guardam seu código, ou arraste-as para a janela; você pode adicionar e remover pastas depois em Ajustes › Pastas.

Você não precisa adicionar as pastas dos próprios agentes. As pastas de agentes na sua pasta pessoal (~/.claude, ~/.codex e as outras) entram em todo escaneamento.

Acesso Total ao Disco

Se uma pasta protegida pelo macOS, como Mesa, Documentos ou Downloads, não puder ser lida, o Devbroom avisa: “1 pasta precisa de Acesso Total ao Disco.” O botão leva você a Ajustes do Sistema › Privacidade e Segurança › Acesso Total ao Disco, onde você ativa o Devbroom. Essa permissão é opcional: sem ela, o Devbroom só não consegue ler essas pastas.

O primeiro escaneamento

O escaneamento começa assim que você escolhe suas pastas. Ele só lê: encontra repositórios git e worktrees, as pastas dos agentes, saídas de build e caches de desenvolvimento, mede quanto espaço cada um ocupa de verdade no disco e confere quais agentes ainda estão rodando.

Entendendo as bolhas

Na tela Armazenamento, tudo o que foi encontrado é uma bolha, do tamanho do espaço que ocupa. Cada bolha recebe seu veredito e entra no seu grupo:

Grupo O que significa
READYPronto Passou em todas as verificações. Já vem selecionado para limpeza.
REVIEWRevisar Vale dar uma olhada antes. Só é limpo se você escolher “Incluir mesmo assim”.
BLOCKEDBloqueado Em uso ou com trabalho dentro. Não pode ser selecionado.
UNKNOWNDesconhecido Evidências insuficientes. Não pode ser selecionado, nunca conta como Pronto.

Clique numa bolha para ver os motivos por trás do veredito: a qual agente pertence, se está em uso, se guarda trabalho não salvo. Ver conteúdo mostra o que há dentro da pasta. Todos os vereditos estão na página de Vereditos.

Limpeza

  1. Clique em Limpar. O Devbroom verifica de novo, na hora, os itens selecionados: “Verificando 27 itens de novo.”
  2. A prévia mostra o que vai acontecer: “Mover 27 itens para a Lixeira”, o tamanho total e cada item. O que você escolheu e não passou na verificação aparece em “Deixados de fora”, com o motivo.
  3. Confirme e os itens vão para a Lixeira. Se algo mudou desde o escaneamento, fica onde está, e você fica sabendo por que foi pulado.
  4. O espaço movido para a Lixeira continua ocupando o disco até você esvaziá-la; o Devbroom avisa: “movido para a Lixeira · o espaço volta quando você esvaziá-la”.

Se mudar de ideia, Restaurar traz tudo de volta; depois, você ainda pode restaurar os itens um por um pelo Histórico. Apagar permanentemente é uma escolha à parte, confirmada mantendo o botão pressionado.

As worktrees não vão para a Lixeira: são removidas com o git, o HEAD delas é salvo antes numa ref de recuperação, e o branch continua lá.

Manutenção automática

Em Ajustes › Manutenção automática você escolhe quando o Devbroom escaneia sozinho (desligado, diariamente ou semanalmente) e quantos GB precisam estar prontos para ele avisar. Os escaneamentos automáticos só leem.

Você também pode criar regras, como “pastas de build com mais de 90 dias”. Por padrão, uma regra pergunta antes. Escolha “Fazer por conta própria” e ela move só itens Prontos, e só para a Lixeira; cada um pode ser restaurado. A menos que você ative isso, o Devbroom não muda nada sem o seu OK. A Manutenção automática faz parte do Pro.

Sessões

A aba Sessões mostra o histórico de sessões dos seus agentes por pasta: quais estão rodando, quanto espaço ocupam, as que são de pastas que não existem mais, e o valor estimado dos tokens usados pelos preços de tabela da API, incluindo os últimos 30 dias. Esses números são calculados só no seu Mac.

  • Busca: procura no que foi dito nas suas sessões. Os registros são lidos naquele momento, nada é indexado; trechos que parecem segredos são ocultados nos resultados.
  • Arquivar conversas: empacota as conversas do Claude Code de uma pasta num arquivo, verifica esse arquivo e depois move os originais para a Lixeira. A memória do projeto fica onde está. claude --resume não abre conversas arquivadas até que sejam reabertas; você pode reabri-las pelo Histórico.

Uso e custo, busca e arquivamento fazem parte do Pro.

Barra de menus

O Devbroom também fica na barra de menus: mostra quanto estava pronto depois do último escaneamento e, durante um escaneamento, o progresso; dali você pode escanear de novo ou parar o escaneamento. Feche a janela e o Devbroom sai do Dock e continua rodando na barra de menus; para sair de vez, pressione ⌘Q.

Pro

Escanear, vereditos, limpeza, restauração, a linha de comando e o MCP são grátis. Manutenção automática, Análises e as ferramentas de sessão fazem parte do Pro. Nos primeiros 14 dias todo o Pro fica liberado; sem cartão, conta ou e-mail. Quando o teste acaba, nada é apagado: suas regras ficam pausadas e seu histórico continua. O Pro custa $29 uma única vez, para 2 Macs; detalhes na página de Preços.

PróximaVereditos

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