Cómo funciona Wipecraft

En el uso diario

Tu trabajo se queda donde está

Las filas que contienen trabajo en curso están bloqueadas. Puedes verlas, pero no seleccionarlas.

Mientras Claude Code o Codex se ejecuta: las sesiones que tiene abiertas, todo lo que cambió en las últimas 24 horas y el worktree en el que trabaja.
Las cachés de Cursor mientras Cursor está abierto.
Un worktree con cambios sin hacer commit, uno que cambió en los últimos 7 días o uno cuyos commits no están en la rama principal ni en un remoto.
Un simulador arrancado.
La imagen activa del sandbox de Claude Desktop.

No hay nada seleccionado de entrada. «Seleccionar recomendados» elige solo elementos de «Eliminación segura» y «Vuelve», y nunca uno de «Tú decides».

El escaneo solo lee. Un test compara cada archivo de una carpeta de inicio de prueba antes y después de un escaneo completo, y de nuevo después del escaneo y el estado por línea de comandos.

7 días para cambiar de opinión

Los archivos que ninguna app vuelve a crear van a la cuarentena en el mismo disco cuando los eliminas. Cada fila muestra los días que quedan y un botón Restaurar. Pasados 7 días, la cuarentena se vacía sola la próxima vez que Wipecraft se abre o hace su comprobación diaria. Si necesitas el espacio hoy, «Vaciar ahora» lo libera tras una segunda confirmación.

Tres tipos de acción no pasan por la cuarentena.

Las cachés, los registros y los archivos temporales que su app vuelve a crear sola se eliminan directamente. No se pueden restaurar, y la fila o la tarjeta lo dice antes de que confirmes. Wipecraft lo hace solo con las carpetas y los archivos de los que sabe que una app los recrea. Si no se conoce ninguna app que vuelva a crear un elemento, este va a la cuarentena.
Los worktrees se eliminan con git; su rama se queda en el repositorio.
Unos pocos comandos de herramientas están marcados como «Irreversible», y Wipecraft los nombra y vuelve a preguntar.

Algunas cachés se quedan en la cuarentena porque su herramienta no las recupera sola: las cachés de JetBrains y Android Studio (que también guardan el historial local del IDE), los módulos de Maven y de Go, y los datos de herramientas en Library/Caches, como los entornos de Poetry, los navegadores de Playwright y Cypress y los modelos de llama.cpp.

Los historiales de sesiones no se eliminan. Pasan a un archivo comprimido en Archivados que puedes restaurar.

Te avisa cuando algo crece

La supervisión está desactivada hasta que la activas. Cuando está activada, un icono en la barra de menús lo indica, y Wipecraft hace una comprobación al día a la hora que elijas. Te avisa cuando:

un elemento crece 2 GB o más en 7 días,
queda libre menos del 10 % del disco,
un worktree o simulador de 1 GB o más lleva 7 días sin tocarse,
tu última copia de seguridad de Time Machine tiene más de 7 días.

Si sales de la app, todo se detiene.

Reglas que tú defines, y filtros

Las reglas de limpieza son opcionales. No hay ninguna hasta que añades una en Ajustes > Limpieza automática.

Una regla indica las fuentes, cuántos días debe llevar un elemento sin usarse (de 7 a 365) y un tamaño mínimo.
Tras la comprobación diaria, los elementos que cumplen una regla pasan a la cuarentena o a Archivados, y una notificación indica cuántos.
Las reglas omiten las filas bloqueadas. Nunca ejecutan un comando, nunca eliminan un worktree y nunca hacen nada que no se pueda deshacer. Las cachés que se eliminan directamente no forman parte de la limpieza programada; las reglas solo toman elementos que van a la cuarentena o a Archivados.
Las reglas solo se ejecutan mientras la supervisión está activada.
Sin licencia, una regla no mueve nada. Si una regla hubiera movido algo, Wipecraft te avisa una vez al día de que la limpieza no se ejecutó.

Cada lista de resultados se puede filtrar por el tiempo que un elemento lleva sin tocarse, por fuente y por nivel de seguridad. Un filtro oculta filas y las quita de la selección.

Nunca toca trabajo sin push

Un worktree cuyo repositorio git sigue existiendo solo se ofrece para eliminar cuando sus commits también están en otro sitio. La única excepción es un worktree cuyo repositorio ya no existe; consulta el último punto.

Sus commits tienen que estar en la rama principal o en una rama remota. Si no lo están, la fila se bloquea con el motivo «Sus commits aún no están en la rama principal ni en un remoto.»
Los commits hechos después del último push lo mantienen bloqueado.
Un squash merge pone commits nuevos en la rama principal, así que los commits propios de la rama nunca aparecen allí. Si GitHub muestra el pull request de la rama como fusionado, Wipecraft quita ese bloqueo concreto. Lo consulta mediante tu propia sesión de gh, solo cuando gh está instalado y con la sesión iniciada, y puedes desactivarlo en Ajustes > Privacidad. Los cambios sin hacer commit siguen bloqueando el worktree.
Wipecraft vuelve a comprobarlo justo antes de eliminar un worktree. Si los commits ya no están en la rama principal ni en un remoto, o el pull request ya no aparece como fusionado, no elimina nada.
Git no puede comprobar un worktree cuyo repositorio principal se movió o se eliminó. Wipecraft lo ofrece solo tras 30 días sin cambios (el valor predeterminado) y mueve la carpeta entera a la cuarentena, desde donde Restaurar la devuelve.

Conserva tu .env al eliminar un worktree

git worktree remove elimina la carpeta, incluidos los archivos que git ignora: .env, bases de datos locales y ajustes del editor. Wipecraft saca antes esos archivos.

Antes de eliminar un worktree, Wipecraft mueve a la cuarentena, durante 7 días, sus archivos ignorados que no son salida de compilación. La salida de compilación, como node_modules y target, se elimina con el worktree.
La fila indica cuántos archivos van a la cuarentena antes de que confirmes.
Si git se niega a eliminar el worktree, Wipecraft devuelve los archivos a donde estaban.
Restaurar vuelve a crear las carpetas en las que estaban esos archivos.
Estos archivos nunca se ofrecen por separado. La salida de compilación se ofrece como una fila aparte, también para un worktree que está bloqueado.

Funciona desde el terminal y dentro de Claude Code

Línea de comandos. Wipecraft incluye un comando wipecraft dentro de la app. Ajustes > General > Herramienta de línea de comandos muestra la línea que lo enlaza en tu PATH.

wipecraft scan y wipecraft status listan lo que se puede liberar, e imprimen JSON con versión con --json. No cambian nada.
wipecraft clean muestra lo que haría. Nada cambia hasta que añades --apply.
Con --apply, wipecraft clean hace con cada elemento que nombras lo mismo que la app: las cachés, los registros y los archivos temporales que su app vuelve a crear se eliminan directamente y no se pueden restaurar (el plan dice «Would remove directly»), los demás archivos van a la cuarentena, los historiales de sesiones van a Archivados y un worktree terminado se elimina con git worktree remove después de que sus archivos ignorados que no son salida de compilación pasen a la cuarentena. El registro de eliminaciones anota cada acción. --all-safe elige solo elementos que van a la cuarentena. Necesita la misma licencia que la app.
Rechaza las filas bloqueadas y las filas que cambiaron desde el escaneo. No ejecuta las acciones marcadas como «Irreversible»; te indica que abras la app.
wipecraft quarantine list muestra lo que hay en la cuarentena, y wipecraft quarantine restore <id> devuelve una entrada a su sitio. Ninguno de los dos necesita licencia.
Si la app u otro terminal está moviendo archivos, el comando se detiene con un mensaje de que Wipecraft está ocupado, y no mueve nada.
Imprime scripts de autocompletado para zsh, bash y fish.

Plugin de Claude Code. El plugin añade dos comandos y dos hooks de sesión.

/wipecraft:status resume wipecraft scan --json. /wipecraft:tidy muestra primero la ejecución de prueba y ejecuta --apply solo después de que digas que sí en el chat.
Cuando empieza una sesión y se puede liberar más de 1 GB, añade una línea a la sesión. La línea sale de un resumen guardado en la última actualización, así que una sesión nunca espera a un escaneo. Sin un resumen de las últimas 24 horas no imprime nada, y actualiza el resumen en segundo plano.
Cuando una sesión termina dentro de un worktree enlazado, imprime en una línea el estado de ese worktree.
Limpiar un worktree terminado está desactivado de forma predeterminada. Es un interruptor en Ajustes > Agentes.
Con el interruptor activado, wipecraft clean se ejecuta en segundo plano tras una breve espera cuando termina la sesión, solo para el worktree de esa sesión. Pasa por las mismas comprobaciones que el comando, y un worktree que sigue bloqueado se queda.

Otros agentes (MCP). wipecraft mcp es un servidor que Claude Code, Codex, Cursor y otros agentes pueden iniciar en tu Mac. Solo se comunica por la entrada y la salida estándar; su código fuente no usa ninguna conexión de red y no escucha en ningún puerto.

Un agente puede leer los totales, listar y explicar elementos, y ver lo que hay en la cuarentena. Estas peticiones no cambian nada.
La limpieza mediante un agente está desactivada hasta que activas «Permitir que los agentes limpien mediante MCP» en Ajustes > Agentes.
Cuando está activada, una petición muestra el plan salvo que el agente pida aplicarlo. Aplicar necesita una licencia y omite las filas bloqueadas. Para cada id que nombra el agente, hace lo mismo que wipecraft clean --apply: las cachés, los registros y los archivos temporales que su app vuelve a crear se eliminan directamente y no se pueden restaurar, los demás archivos van a la cuarentena, los historiales de sesiones van a Archivados y un worktree terminado se elimina con git. La descripción de la herramienta le dice al agente qué elementos no se pueden restaurar, para que lo diga antes de aplicar. Las acciones marcadas como «Irreversible», como eliminar una instantánea local de Time Machine, se siguen rechazando.
Ajustes > Agentes muestra el texto de configuración para Claude Code, Codex y Cursor. Wipecraft muestra el texto y no cambia los ajustes de ningún agente.

Qué encuentra

Cada fila dice qué es, cuánto ocupa y qué pasa si lo eliminas. Cuando algo puede volver, también dice cómo.

Claude Code, Codex, los worktrees y las herramientas de desarrollo de abajo aparecen cuando el Modo de desarrollador está activado. Consulta las preguntas frecuentes.

Agentes de IA y apps de IA

Claude Code. Historiales de sesiones, agrupados por proyecto y mes. Se archivan, no se eliminan. También el historial de archivos, las instantáneas de shell, los registros de depuración y los plugins.
Codex. Sesiones, sesiones archivadas y las bases de datos del historial de hilos y de registros. Todo esto se archiva, no se elimina. También las imágenes generadas y la caché.
Claude Desktop. Paquetes de VM. La imagen activa del sandbox se muestra y está bloqueada. Sus copias comprimidas y los datos de inicio rápido sobrantes solo se ofrecen mientras Claude Desktop está cerrado. También las cachés.
Cursor. Sus cachés.
Modelos locales. Ollama, LM Studio, la caché de Hugging Face, la caché de PyTorch y los modelos de Whisper, con su tamaño y su último uso.
Worktrees de git. De cualquier agente, o tuyos: los worktrees de los repositorios git de tu carpeta de inicio y las carpetas de .claude/worktrees. Cada uno muestra su rama, su tamaño, su último cambio y, por separado, los archivos que git ignora. Los worktrees se agrupan por la herramienta que los creó: Claude Code, Codex, Cursor u Otros. El grupo sale de la carpeta o del nombre de la rama.
Restos de worktrees. Se listan las carpetas cuyo repositorio principal se movió o se eliminó, y también los registros de git de worktrees cuyas carpetas ya no existen. Quitar esos registros ejecuta git worktree prune, que no elimina ningún archivo. Un registro cuya carpeta se movió, pero no se eliminó, se queda bloqueado, y la fila indica que ejecutes git worktree repair.

Herramientas de desarrollo

Xcode. Datos de compilación por proyecto, archivos de Xcode (archives), archivos de soporte de dispositivos, previsualizaciones y la caché de módulos. Un proyecto que Xcode tiene abierto está bloqueado.
Simuladores. Cada dispositivo con su tamaño y su último uso. «Eliminar dispositivo» y «borrar contenido» son acciones distintas. Las imágenes de runtime solo se ofrecen cuando ningún simulador las usa.
Cachés de paquetes. npm, pnpm, Yarn, pip, Homebrew, CocoaPods, Swift Package Manager, Gradle y Cargo, y también Bun, uv, conda, Go y Maven.
Salida de compilación. node_modules en proyectos que no han cambiado en 30 días. También carpetas como .venv, target, .next, build, dist, Pods y .build, solo cuando el proyecto tiene su archivo marcador (por ejemplo Cargo.toml o package.json), git ignora la carpeta y el proyecto no ha cambiado en 30 días. Puedes cambiar los 30 días. Un agente de programación o un editor iniciado en la carpeta del proyecto la bloquea mientras se ejecuta.
Editores. Cachés y registros de VS Code, los IDE de JetBrains y Android Studio. Están bloqueados mientras ese editor se ejecuta. Una carpeta de una versión anterior de un IDE lo indica.
Android. Emuladores (dispositivos virtuales) e imágenes del sistema del SDK. Un emulador se mueve a la cuarentena y está bloqueado mientras se ejecuta un emulador o existe su archivo de bloqueo. Una imagen del sistema está bloqueada mientras un dispositivo la usa, y también cuando Wipecraft no puede leer los ajustes de un dispositivo.
Docker. Imágenes y volúmenes, mientras Docker se está ejecutando. Una imagen o un volumen que usa un contenedor está bloqueado. También la caché de compilación que ninguna compilación usa ahora; eliminarla ejecuta docker builder prune --all --force, que no se puede deshacer. La carpeta de datos de OrbStack se muestra con su tamaño y Wipecraft no la elimina.

Datos del sistema

El panel Almacenamiento de Ajustes del Sistema muestra una sola cifra para Datos del sistema. Wipecraft parte del espacio usado del disco y reparte cada byte usado en cuatro partes: macOS, Apps, Tus archivos y Datos del sistema. Las partes suman el espacio usado.

Datos del sistema se divide a su vez en cinco grupos. Cada uno tiene un color y una explicación de una frase.

Tu Mac lo necesita. El archivo de intercambio, las bases de datos del sistema y los datos que las apps guardan para sí mismas. Se muestra, pero nunca se ofrece para eliminar.
Eliminación segura. Cachés, registros y archivos temporales que su app vuelve a crear sola.
Vuelve. Se puede eliminar, pero se llena de nuevo con el uso, como las cachés de los navegadores y de paquetes.
Tú decides. La única copia de algo que no vuelve solo, como modelos locales, emuladores, simuladores, worktrees, imágenes de Docker y historiales de sesiones. La tarjeta dice qué es cada uno y cuándo lo usaste por última vez. Van a la cuarentena, donde puedes restaurarlos durante 7 días, o a Archivados, que puedes restaurar.
macOS no lo muestra. Lo que queda después de restar todo lo que Wipecraft puede nombrar, con un motivo: el Acceso total al disco está desactivado, hay carpetas que solo un administrador puede leer, o la sobrecarga de APFS y los clones.

La papelera de una tarjeta elimina solo lo que es seguro: los elementos de «Eliminación segura» y «Vuelve» que no están bloqueados. Nunca toma un elemento de «Tú decides», y un elemento que una app tiene abierto sigue bloqueado. La tarjeta se da la vuelta primero y dice qué va a pasar y si se puede deshacer.

Las instantáneas locales de Time Machine se listan una a una, con sus fechas, fuera de los grupos. macOS no indica el tamaño de una instantánea local, así que Wipecraft no lo calcula a ojo. Eliminar una instantánea está marcado como «Irreversible» y pide tu contraseña de administrador cada vez.

Algunas de estas carpetas necesitan Acceso total al disco. Sin él, tus carpetas de usuario se escanean igualmente, y el resumen indica qué carpetas no se pudieron contar.

Cómo funciona deshacer

Tipo de fila	Qué hace Wipecraft	Cómo lo recuperas
Se regenera solo	Lo elimina directamente, sin pasar por la cuarentena. Solo para cachés, registros y archivos temporales que su app vuelve a crear. La fila o la tarjeta lo dice antes de que confirmes.	No hay nada que restaurar. La app lo vuelve a crear cuando lo necesita. No se puede deshacer.
Recuperable	Mueve los archivos a la cuarentena.	Restaurar, en un plazo de 7 días. O volver a descargarlo o a compilarlo.
Historiales de sesiones (etiquetados «Recuperable»)	Los comprime en un archivo en Archivados y después elimina los originales.	Restaurar el archivo comprimido. Los archivos comprimidos se quedan hasta que los restauras.
Worktree (etiquetado «Recuperable»)	Mueve a la cuarentena sus archivos ignorados que no son salida de compilación (como `.env`) y después ejecuta `git worktree remove`. La carpeta se elimina directamente, sin pasar por la cuarentena, junto con su salida de compilación.	La rama se queda en el repositorio. Ejecuta `git worktree add` con la rama para volver a tenerla en un worktree. Restaurar devuelve los archivos conservados.
Irreversible	Ejecuta un comando propio de la herramienta. Primero nombra el comando y te pregunta una segunda vez.	La confirmación indica cómo volver a obtenerlo.
Bloqueado	Nada.	No hay nada que recuperar.

Las cachés que su herramienta no recupera sola no están en la primera fila. Van a la cuarentena: las cachés de JetBrains y Android Studio, los módulos de Maven y de Go, y los datos de herramientas en Library/Caches, como los entornos de Poetry, los navegadores de Playwright y Cypress y los modelos de llama.cpp.

Las acciones irreversibles son: eliminar una instantánea local de Time Machine, eliminar un runtime de simulador, borrar el contenido de un simulador, eliminar una imagen o un volumen de Docker y eliminar la caché de compilación de Docker.

Wipecraft ofrece para eliminar un worktree cuyo repositorio existe solo cuando está limpio: sin archivos con seguimiento modificados, sin archivos sin seguimiento que git no ignore, sin cambios en 7 días (el valor predeterminado; puedes cambiarlo en Ajustes) y con sus commits en la rama principal o en un remoto. Git no puede comprobar un worktree cuyo repositorio principal ya no existe. Se ofrece tras 30 días sin cambios (el valor predeterminado) y va a la cuarentena como carpeta entera. Sus archivos ignorados por git (salida de compilación, dependencias) también son una fila aparte, que va a la cuarentena. Esa fila se puede ofrecer incluso cuando el worktree en sí está bloqueado, por ejemplo por cambios sin hacer commit.

La cuarentena mueve archivos dentro del mismo disco, así que el espacio vuelve cuando se vacía. La pantalla Cuarentena muestra las dos cifras: «En cuarentena» y «Se libera si se vacía ahora».

Cada acción se anota en un registro de eliminaciones local: cuándo, qué, cuánto y qué tipo de acción. Puedes exportarlo como CSV desde Ajustes.

La privacidad en 10 principios

Sin cuenta.
Sin telemetría ni analítica en la app.
Wipecraft no envía ningún nombre de archivo ni ruta a ninguna parte. Un agente de programación que conectas tú mismo recibe resultados del escaneo en tu Mac, por una conexión local. Lo que ese agente haga con ellos es asunto de su propio proveedor.
El escaneo lee tamaños, fechas y el estado de herramientas (git, simctl, Docker) en este Mac. No sube nada.
La app hace llamadas de red para dos cosas: tu licencia, si activas una (con el nombre de tu Mac como etiqueta de la activación), y la búsqueda de actualizaciones. Una comprobación opcional pasa por tu propia sesión de gh, solo cuando gh está instalado y con la sesión iniciada. Puedes desactivarla en Ajustes, y entonces gh no se ejecuta nunca.
Los informes de fallos están desactivados de forma predeterminada. Si los activas, solo se envían cuando la app falla, sin nombres de archivo ni rutas (Sentry, región de la UE).
Nada se ejecuta en segundo plano salvo que actives la supervisión, y su icono en la barra de menús indica que está activada. El otro caso es el plugin de Claude Code, si lo instalas: sus hooks ejecutan wipecraft cuando una sesión empieza o termina.
No se instala ningún asistente con permisos de administrador. La contraseña de administrador solo se pide para eliminar una instantánea, cada vez. El comando wipecraft se ejecuta con tus propios permisos y no ejecuta comandos de administrador.
El registro de eliminaciones se queda en tu Mac. Lo exportas tú.
Tu clave de licencia se guarda en tu llavero. El comando wipecraft la lee de ahí para comprobar la licencia.

Todos los detalles: wipecraft.app/privacy/es