Reglas

El miedo de verdad no es el espacio perdido, es perder trabajo. Para eso están las reglas de Devbroom, y ninguna es un ajuste.

El escaneo solo lee

El escaneo no cambia ni un archivo. Salvo que pongas una regla en “Hacerlo por su cuenta” en Mantenimiento automático, no se toca nada que no hayas visto en la vista previa y confirmado.

Cada veredicto llega con un motivo

Ningún elemento está Listo o Bloqueado sin un motivo. Los motivos de cada veredicto se muestran junto al elemento, y en la línea de comandos con --details.

Bloqueado y Desconocido no se pueden seleccionar

Es un límite, no una preferencia. Los elementos en Revisar solo se limpian con “Incluir de todos modos”; en la línea de comandos es --include-review, y pide confirmación en la terminal.

Se comprueba de nuevo justo antes de borrar

Cuando pulsas Limpiar, cada elemento se vuelve a comprobar con los procesos que se están ejecutando en ese momento. Un elemento cuyo veredicto o contenido cambió desde el escaneo se deja como está, y se te dice por qué se omitió.

Primero la Papelera

La Papelera es lo predeterminado, y cada elemento se puede restaurar desde el Historial. Borrar de forma permanente es una opción aparte, que se confirma manteniendo pulsado su botón; tu organización puede desactivarla. El espacio movido a la Papelera no cuenta como liberado hasta que la vacías.

Worktrees: nunca --force

  • Un worktree con cambios sin confirmar, o con archivos sin seguimiento o preparados, queda Bloqueado. Git no lo elimina sin --force; Devbroom nunca usa --force.
  • Los archivos ignorados lo dejan en Revisar, porque git worktree remove los borra sin preguntar.
  • Los commits sin subir de una rama se conservan al eliminar el worktree; con un HEAD separado (detached) no se conservarían. Por eso, antes de eliminar, Devbroom guarda el HEAD en refs/devbroom/removed; si no puede, no elimina.
  • Solo hay tres acciones para worktrees: eliminar (remove), podar (prune) y reparar (repair).

No toca el trabajo en curso

Si hay una sesión de agente en ejecución en esa carpeta o en su carpeta superior, un proceso se ejecuta desde ella o hay un archivo suyo abierto, el elemento queda Bloqueado. En las carpetas de build, una sesión en ejecución en la carpeta superior lo deja en Revisar.

Devbroom nunca toca los procesos de una sesión de agente en ejecución. A los procesos que los agentes dejaron atrás solo les pide que se cierren cuando tú lo dices, y solo después de volver a comprobar; nunca a procesos del sistema ni de otros usuarios.

El nombre no basta

El nombre de una carpeta, por sí solo, no es ninguna prueba:

Carpeta Para estar Lista
node_modules Un package.json al lado
.next Una configuración de Next.js o un package.json al lado
.turbo Un turbo.json o un package.json al lado
target El marcador de Cargo dentro (CACHEDIR.TAG)
.venv Un pyvenv.cfg dentro
DerivedData Archivos de Xcode dentro
dist, build, vendor Un archivo de proyecto al lado y un script de build que la genere

Sin el marcador, la carpeta se queda en Revisar. Además, tiene que ser una carpeta que git ignore, sin ningún archivo dentro al que git haga seguimiento.

Tamaño real

El espacio compartido con otras carpetas mediante enlaces duros y clones de APFS (como hace pnpm) no se cuenta. La cifra que ves es lo que libera borrarlo. Los enlaces simbólicos no se siguen y los volúmenes montados se omiten.

A la manera del agente

Las bases de datos y credenciales de los agentes nunca se tocan. Cuando un agente tiene su propio comando de limpieza, se hace o se te indica de esa forma. El historial de Claude Code se borra con claude purge o se archiva: primero las conversaciones se escriben en un archivo dentro de la carpeta de Devbroom y se verifican con los originales, y solo entonces se mueven a la Papelera; la memoria del proyecto (memory/) se queda en su sitio, y el archivo se puede reabrir desde el Historial. Para las sesiones de Codex se indica codex delete. Las sesiones de otros agentes solo se leen.

Todo en tu Mac

Sin cuenta, sin telemetría; no se envía nada sobre ti. La app busca actualizaciones; si introduces una licencia Pro, la activa una vez y la vuelve a comprobar en silencio más o menos una vez al mes (solo la clave de licencia y el nombre de tu Mac). Sin licencia, la búsqueda de actualizaciones es la única petición de red. De los registros de sesión solo toma el número de tokens y los nombres de los modelos; buscar en las sesiones lee los registros en ese momento, no guarda índices ni registros y oculta en los fragmentos las cadenas que parecen secretos. Detalles en la página de Privacidad.

Última actualización: 7 de octubre de 2026