Integrações

Seus agentes, Atalhos e scripts podem acessar o que o Devbroom sabe. Nenhum deles limpa sozinho: os pedidos dos agentes e os links chegam a você no app, e devbroom clean mostra primeiro e pergunta.

Tudo fica em Ajustes › Agentes e integrações. Primeiro vincule a ferramenta de linha de comando como ~/.local/bin/devbroom com “Vincular devbroom”; o MCP e o Raycast a usam.

MCP para agentes

devbroom mcp é um servidor MCP que conversa com o agente que o iniciou, neste Mac. Ele nunca se abre para a rede. Oferece três ferramentas:

Ferramenta	O que faz
`devbroom_status`	Lê o último escaneamento do app; não escaneia de novo.
`devbroom_check`	Diz se uma pasta pode ser apagada e por quê. Só aceita caminhos dentro das pastas que você escolheu.
`devbroom_request_cleanup`	Pede para limpar uma ou mais pastas, com um motivo. O pedido chega a você no app. Nada é limpo até você confirmar, e cada item é verificado de novo depois disso.

A linha de comando e o MCP são grátis. Para adicioná-lo ao seu agente:

Claude Code

$ claude mcp add --scope user devbroom -- ~/.local/bin/devbroom mcp

Codex · ~/.codex/config.toml

[mcp_servers.devbroom]command = "/Users/<user>/.local/bin/devbroom"args = ["mcp"]tool_timeout_sec = 180

Cursor · ~/.cursor/mcp.json

{ "mcpServers": { "devbroom": { "command": "/Users/<user>/.local/bin/devbroom", "args": ["mcp"] } } }

Ajustes › Agentes e integrações preenche estas linhas com o caminho do seu Mac.

Links

O Devbroom conhece três links. Eles só abrem o app; a limpeza espera por você.

Link	O que faz
`devbroom://scan`	Escaneia de novo.
`devbroom://clean`	Abre a prévia de limpeza do que está Pronto.
`devbroom://open`	Abre o app. Com `?tab=storage`, `worktrees` ou `sessions`, vai para aquela aba.

Qualquer outro link é ignorado. Use-os no Atalhos com a ação “Abrir URLs”, ou pelo Raycast.

Para scripts

devbroom status --json entrega o último escaneamento do app: quanto está pronto, quando foi escaneado e os maiores itens Prontos. Não escaneia de novo. Detalhes na página de Linha de comando.

Análises

As Análises mostram como os dados dos agentes crescem e o que o Devbroom limpou: espaço livre neste Mac, o que foi limpo este ano e o que ainda está na Lixeira, o crescimento nos últimos 30 dias, o que cresce mais rápido, o crescimento por agente e as contagens de tokens das sessões dos agentes, com o custo estimado pelos preços de tabela da API. Tudo é montado a partir do resumo de cada escaneamento; o gráfico aparece depois de três escaneamentos. Tudo fica no seu Mac. As Análises fazem parte do Pro.

Para organizações

Uma organização pode definir parte do comportamento do Devbroom com um perfil de configuração (MDM) no domínio com.devbroom.desktop. Só contam os valores que o perfil impõe; o app os mostra como bloqueados e o usuário não pode mudá-los. O app e a linha de comando os leem de novo toda vez que rodam.

Chave	O que faz
`ProtectedPaths`	Pastas que o Devbroom nunca vai sugerir limpar, além das proteções do próprio usuário.
`ProtectedNames`	Nomes de pastas que nunca são sugeridos para limpeza, estejam onde estiverem.
`AllowPermanentDelete`	`false`: só mover para a Lixeira. Apagar permanentemente e esvaziar a Lixeira ficam desativados no app e na linha de comando.
`AllowCommandLineClean`	`false`: `devbroom clean` não roda; o escaneamento sim.
`AllowAgentRequests`	`false`: pedidos de limpeza dos agentes via `devbroom mcp` não são aceitos; a leitura funciona.

Isto é uma política para o Devbroom, não uma barreira de segurança: o usuário ainda pode apagar arquivos à mão. Para uma licença de equipe, escreva para nós.

AnteriorLinha de comando PróximaVisão geral

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