Línea de comandos

devbroom lleva el escaneo de la app a la terminal: los mismos veredictos, los mismos motivos. El escaneo no borra, no mueve y no cambia nada; limpiar es un comando aparte.

La línea de comandos es gratis. El escaneo solo lee. devbroom clean hace lo mismo que el botón Limpiar de la app: primero muestra lo que está Listo, pregunta y luego lo mueve a la Papelera. Las protecciones que configuras en la app también se aplican aquí.

Instalación

devbroom viene dentro de la app; no hay nada más que instalar. Pulsa “Enlazar devbroom” en Ajustes › Agentes e integraciones y el comando queda enlazado como ~/.local/bin/devbroom. Si la app no está en la carpeta Aplicaciones, muévela allí primero o el enlace se rompe. Después abre una terminal nueva y comprueba la versión.

Terminal

$ devbroom --versiondevbroom 0.1.0

Si ~/.local/bin no está en el PATH de tu shell, ejecuta el comando con su ruta completa o añade esa carpeta a tu PATH.

Uso

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

Sin ruta, se escanea la carpeta en la que estás. Puedes indicar varias rutas. Los datos de los agentes en tu carpeta de inicio forman parte de cada escaneo.

Ejemplos

$ devbroom                        # la carpeta en la que estás$ devbroom ~/projects ~/work      # varias carpetas$ devbroom ~/projects --details   # con todos los motivos$ devbroom ~/projects --all       # todos, no solo los más grandes

Opciones

Opción	Qué hace
`-d, --details`	Muestra todos los motivos de cada veredicto.
`-a, --all`	Lista todos los elementos encontrados, no solo los más grandes.
`--json`	Escribe el informe completo en JSON.
`--no-color`	Desactiva los colores. Tampoco se usan colores si `NO_COLOR` está definida.
`-h, --help`	Muestra la ayuda.
`-V, --version`	Muestra la versión.
`--`	Trata todo lo que va detrás como una ruta: `devbroom -- -odd-folder`

Una opción desconocida es un error, y no se escanea nada.

Limpieza

devbroom clean escanea, prepara un plan nuevo con lo que está Listo, muestra el plan y, solo después de tu aprobación, mueve esas carpetas a la Papelera. Lo que hizo aparece en el Historial de la app; si ya hay una limpieza en curso en la app, no espera: termina.

Terminal

$ devbroom clean ~/projects --dry-run   # solo mostrar$ devbroom clean ~/projects             # mostrar, preguntar, mover a la Papelera

Opción	Qué hace
`-n, --dry-run`	Muestra el plan y no cambia nada.
`--delete`	Borra de forma permanente en lugar de mover a la Papelera. No está disponible si tu organización desactivó el borrado permanente.
`--include-review RUTA`	Añade al plan un elemento en Revisar; es el “Incluir de todos modos” de la app. Pide confirmación en la terminal y no se puede usar con `--yes`. Se puede indicar más de una vez.
`-y, --yes`	Limpia sin preguntar.
`--json`	Escribe el plan y el resultado en JSON.

Sin ruta, usa las carpetas que elegiste en la app, o la carpeta en la que estás si la app nunca se configuró. clean solo limpia carpetas de build, carpetas temporales de agentes y cachés; los worktrees y los datos de los agentes se limpian en la app.

Cuando no hay una terminal en la que preguntar, o se indica --yes, es más estricto: los elementos que están Listos solo por el .devbroom.toml de un proyecto se quedan fuera del plan, porque ese archivo lo podría haber escrito un agente. Sin terminal y sin --yes, no cambia nada.

Estado

devbroom status muestra el último escaneo de la app sin volver a escanear: cuánto hay listo para limpiar, hace cuántos minutos se escaneó y los elementos Listos más grandes. --json devuelve lo mismo en JSON. Si la app aún no ha escaneado, es un error.

MCP para agentes

devbroom mcp es un servidor MCP. Claude Code, Codex o Cursor pueden leer el último escaneo, preguntar por qué una carpeta está Lista o Bloqueada y pedirte que limpies; la petición te llega en la app, y nunca limpia nada por su cuenta. La configuración está en la página de Integraciones.

Cómo leer la salida

El informe está escrito en inglés y tiene cuatro partes. Cada línea empieza con el veredicto del 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: Los agentes de este Mac: versión, espacio ocupado, número de sesiones, cuántas son de carpetas que ya no existen y cuántas están en ejecución.
Cleanup potential: Tamaño total y número de elementos de cada veredicto.
Worktrees: La acción sugerida para cada worktree (remove, prune, repair) y su veredicto.
Largest items: Los elementos más grandes, con sus motivos. --all los muestra todos.

Veredictos

La línea de comandos usa los cuatro veredictos de la app, escritos en mayúsculas y en inglés.

En la salida	Qué significa
READYListo	Pasó todas las comprobaciones para esta acción.
REVIEWRevisar	Un riesgo conocido, o una decisión que solo puedes tomar tú; por ejemplo, un archivo `.env` ignorado.
BLOCKEDBloqueado	En uso, protegido o con trabajo que git se negaría a descartar.
UNKNOWNDesconocido	No hay pruebas suficientes. Nunca cuenta como Listo.

Salida JSON

--json escribe el informe completo; es útil para scripts e integración continua. El formato se versiona con el campo schema_version, que ahora es 1. Cuando se pide JSON no se escribe ninguna línea de progreso.

Terminal

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

Compatibilidad

devbroom compat muestra qué versiones de los agentes ha probado Devbroom y cuáles están instaladas en tu 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 tu versión está fuera del rango probado pero los archivos del agente tienen el formato esperado, Devbroom funciona y la muestra como “aún no probada”. Si el formato no se mantiene, los datos de ese agente solo se leen; nada de ello cuenta como listo para limpiar.

Códigos de salida

Código	Significado
`0`	Hecho.
`1`	Error.
`2`	Uso incorrecto: una opción desconocida o una ruta que no es una carpeta.
`3`	`clean`: no se confirmó, no cambió nada.
`4`	`clean`: hecho en parte.
`5`	`clean`: hay otra limpieza en curso.
`6`	`clean`: la política de tu organización no lo permite.
`130`	Cancelado (Ctrl-C).

Ctrl-C detiene el escaneo; un segundo Ctrl-C sale de inmediato.

Variables de entorno

Variable	Efecto
`NO_COLOR`	Si está definida, la salida no tiene colores.
`CLAUDE_CONFIG_DIR`	Si la carpeta de ajustes de Claude Code no está en `~/.claude`, se lee desde ahí.
`CLAUDE_CODE_TMPDIR`	Si moviste la carpeta temporal de Claude Code, se lee desde ahí.
`CODEX_HOME`	Si la carpeta de Codex no está en `~/.codex`, se lee desde ahí.
`CURSOR_CONFIG_DIR`	Si la carpeta de Cursor no está en `~/.cursor`, se lee desde ahí.
`XDG_DATA_HOME`, `XDG_CACHE_HOME`, `OPENCODE_DB`	Si los datos y la base de datos de OpenCode están en otro sitio, se leen desde ahí.

AnteriorReglas SiguienteIntegraciones

Última actualización: 7 de octubre de 2026