Documentación

Resumen

La app Mac y la CLI de Mole cubren categorías de limpieza parecidas y comparten las mismas reglas de seguridad prudentes y listas de protección, pero no tienen exactamente las mismas funciones. La CLI es gratuita, open source y con licencia GPL-3.0. La aplicación Mac es una compañera nativa en SwiftUI con licencia de pago único de $19, actualizaciones de por vida y sin suscripción. Ejecuta los flujos de Mac de forma nativa; la CLI añade algunos comandos exclusivos del terminal.

Aplicación Mac

Instalación

Descarga el DMG desde la página de inicio, o instala vía Homebrew: brew install --cask mole-app.

Limpiar (Tierra)

Escanea diez categorías: cachés de aplicaciones, cachés y registros del sistema, herramientas de desarrollo (Xcode, npm, pip, Gradle), herramientas de IA (ChatGPT, Claude, Codex, Copilot, Cursor, Antigravity), navegadores (Chrome, Edge, Arc, Safari, Firefox), clientes de almacenamiento en la nube, herramientas de diseño (Adobe, Figma, Sketch), aplicaciones de comunicación (Slack, Discord, WeChat, Zoom) y archivos temporales varios. La Papelera se muestra aparte al final.

La lista de revisión se ordena por impacto de eliminación: las cachés regenerables aparecen primero, el estado visible para el usuario al final, y la Papelera siempre al final. El cálculo de tamaño con detección de enlaces duros significa que los archivos compartidos entre herramientas (uv, pnpm) no se cuentan dos veces. La eliminación por defecto es permanente para que los bytes liberados coincidan con el titular. Un interruptor en Ajustes redirige todo a través de la Papelera del sistema.

Solo para revisión por defecto: cachés de paquetes con un coste real de reconstrucción (npm, yarn, pnpm, bun, CocoaPods, Gradle, Maven) y salidas de proyecto que pueden regenerarse sin descargar dependencias (build, dist, target, .build, .next, DerivedData, __pycache__, coverage). La app Mac no propone carpetas de dependencias descargadas como node_modules, Pods y venv: reconstruirlas necesita conexión y podría no reproducir el estado del archivo de bloqueo. Estos elementos quedan sin marcar hasta que confirmes; en Ajustes puedes enviar la limpieza a la Papelera.

Software (Marte)

Software combina actualizaciones de apps, gestión de inicio y limpieza de desinstalación. La vista Updates comprueba apps Sparkle, Homebrew Cask / Formula y Mac App Store, luego instala las actualizaciones compatibles en la app o abre el App Store cuando macOS lo exige.

La vista Startup lista Login Items, Launch Agents, Launch Daemons y elementos en segundo plano. Puedes desactivar entradas compatibles, revelar sus archivos o abrir Ajustes del Sistema para elementos gestionados por Apple.

Para desinstalar, elige las apps que quieras eliminar. Mole encuentra restos en más de quince subdirectorios Library, incluidos Application Support, Caches, Preferences, Logs, Launch Agents, Launch Daemons, Login Items, Containers, Group Containers, Saved Application State e Input Methods. Las entradas del Dock se limpian automáticamente y los restos ambiguos o con coincidencias débiles quedan visibles pero sin marcar para revisión.

Las actualizaciones se realizan dentro de la app siempre que es posible: Sparkle y Homebrew Cask se instalan dentro de Mole; Mac App Store pasa por CommerceKit y recae en la app de App Store si hay problemas de autenticación o tiempo de espera; el resto de apps se abren para que su propio actualizador tome el relevo. Cmd-clic añade filas a un lote de desinstalación múltiple, y cualquier fallo individual permanece en la lista para reintentarlo.

Los paquetes /Applications/*.app propiedad de root necesitan una confirmación de administrador en la primera eliminación dentro de una sesión; las eliminaciones siguientes reutilizan esa autorización hasta que cierres Mole. La vista Startup permite a Mole alternar directamente los Login Items y los LaunchAgents / LaunchDaemons verificados cuando puede asociarlos a un servicio launchd estable; las entradas gestionadas por la administración de tareas en segundo plano de macOS sin un identificador claro se enrutan al panel de Ajustes del Sistema correspondiente.

Optimizar (Mercurio)

Las tareas de mantenimiento predeterminadas se ejecutan con un toque. Las tareas sin permisos de administrador se ejecutan en silencio; las tareas admin se agrupan tras una sola autorización cuando hace falta.

Optimize empieza con una pasada visible que reinicia servicios que suelen recuperarse solos, como Dock, cambio de método de entrada, sincronización de iCloud Drive, AirDrop, Spotlight y Centro de notificaciones. Las tareas más profundas incluyen Quick Look, caché de fuentes y recolección de Launch Services, vacuum de SQLite, estados guardados, eventos de cuarentena, historial de notificaciones, preferencias dañadas, Launch Agents, shared file lists, reglas huérfanas de Spotlight, auditoría de elementos de inicio y periodic maintenance.

Las compuertas de seguridad omiten tareas cuando no es seguro: caché de fuentes con navegadores abiertos. Los reinicios de DNS o de la pila de red no forman parte del mantenimiento predeterminado.

Optimize también omite tareas que tocan el estado del dispositivo cuando detecta una VPN activa, HID o audio Bluetooth, o una pantalla o audio externos; las tareas omitidas indican el motivo en el panel de resultados para que veas qué se ejecutó.

Analizar (Júpiter)

Una visualización de mapa de árbol de todo tu disco. Profundiza en cualquier directorio para ver el tamaño en cada nivel. Los elementos densos o de tamaño parecido se agrupan en bloques de resumen para mantener legible el mapa.

Las entradas cuyo tamaño no se pudo calcular (carpetas con permisos restringidos, contenedores protegidos por TCC) se muestran con una opción de reintentar en lugar de descartarse silenciosamente. Las raíces de navegación protegidas (/, /Users, /Applications) no se pueden enviar a la Papelera. Los resultados del escaneo de disco se almacenan en caché durante 24 horas para un acceso rápido.

Un solo clic sobre un directorio del treemap entra dentro; la fila de migas de pan encima del mapa salta a cualquier antecesor. La lista izquierda y los bloques reales del treemap conservan acciones: abrir o mostrar en Finder, y clic derecho para Mover a la Papelera con confirmación. Los bloques de resumen son solo una vista general. El área de cada bloque del treemap es proporcional al tamaño en bytes, así que los mayores consumidores de espacio siempre se ven visualmente más grandes.

Estado (Sol)

El panel bento muestra salud, CPU, memoria, GPU, E/S de disco, red, batería o temperatura, y una tarjeta final de ventiladores o temperatura según el hardware. Cada métrica tiene una mini gráfica de 60 segundos y los Mac compatibles muestran modos de ventilador Auto, Frío y Máx.

La lista de procesos bajo la cuadrícula se actualiza cada segundo. Haz clic en una columna para ordenar; haz clic en una fila para fijarla y mantenerla visible tras los refrescos.

Las cinco columnas (Nombre, PID, CPU, Power, Memoria) se ordenan al hacer clic; un nuevo clic invierte la dirección. Haz clic derecho en una fila para Fijar/Desfijar (conservado entre refrescos y reinicios de la app), Terminate (TERM amable con KILL como respaldo) y copiar la ruta del ejecutable. La fila top drain de la tarjeta Batería enlaza directamente al proceso correspondiente en la hoja de explicación.

HUD de barra de menús

Un monitor opcional siempre visible en la barra de menús de macOS. Elige métricas en vivo, icono compacto o una pequeña animación runner que sigue la carga del sistema. El popover muestra tarjetas de hardware, control de ventiladores si está disponible, procesos principales y resumen Clean Watch.

Las herramientas rápidas viven abajo del popover: indicadores de cámara o micrófono, Keep Screen On con duración, Clean Screen para poner la pantalla en color liso y limpiar pantalla y teclado con bloqueo de entrada opcional, y un botón Eject cuando hay un disco externo o imagen que se puede desmontar. Un atajo global invoca Mole desde cualquier lugar; sin icono del Dock, Mole funciona solo desde la barra de menús. Se configura en Ajustes → Barra de menús.

Alertas de privacidad por app. Cuando una notificación nombra una app, pasa el puntero por encima y elige Dejar de avisar de esta app. Puedes restaurarla después en Ajustes → Barra de menús → Notificaciones → Apps sin alertas de privacidad. Las alertas que solo indican la cámara siguen siendo genéricas porque macOS no revela qué app la usa; por eso Mole no ofrece una acción por app en ellas.

El Modo de visualización alterna entre la animación del runner y una vista Metrics con dos filas configurables. Cada fila puede mostrar de forma independiente CPU, Memoria, Temperatura, Disco o Red. El personaje runner es puramente visual y no cambia las métricas que se muestrean.

Doctor

Desde la barra de menús: Ayuda → Ejecutar Doctor.... Mole genera un breve informe de diagnóstico de solo lectura sobre el modelo de tu Mac, la versión de macOS, los permisos, las operaciones recientes, pantallas, volúmenes externos, red, estado de seguridad y entorno. Usa Copiar informe para un resumen ligero en chat, o Copiar comando de Terminal para crear el paquete completo destinado al soporte privado por correo.

Doctor detecta cinco condiciones: Acceso Completo al Disco ausente, presión de memoria elevada, uso de disco superior al 90%, registro de operaciones no escribible y fallos en operaciones recientes. Cada condición enlaza a un artículo de ayuda con los pasos de resolución. Consulta la página de Ayuda para los detalles de cada una.

Ajustes

Ajustes tiene tres pestañas. General: idioma de interfaz, abrir al iniciar sesión, ocultar icono del Dock, activación de licencia y gestión de dispositivos, acceso rápido al acceso completo al disco. Mantenimiento: modo de eliminación de caché y lista protegida. Battery Care mantiene la batería interna entre el 75 % y el 80 % mientras Mole se ejecuta para ralentizar el desgaste, en Mac compatibles con una autorización de administrador. Barra de menús: monitor de barra de menús, cambio entre runner y métricas, métricas visibles, comportamiento de ventiladores si está disponible y atajos para Menu Bar Toggle / Keep Screen On / Clean Screen. La activación de licencia también se abre con Cmd + Shift + L.

CLI

Instalación

Vía Homebrew: brew install mole. Vía script: curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash. Ejecuta mo para el menú interactivo, o cualquier subcomando directamente.

Comandos compartidos (también en la app Mac)

mo clean

Limpieza profunda de las mismas diez categorías que la app Mac. Admite --dry-run para previsualizar sin eliminar, --debug para registros detallados y --whitelist para gestionar cachés protegidas. Omite automáticamente las cachés de apps en ejecución.

mo uninstall

Selección interactiva de apps con detección de restos. Muestra el tamaño de la app, el ID del paquete y la fecha de último uso. Encuentra las mismas categorías de residuos (más de quince) que la app Mac. Admite --dry-run.

mo optimize

Ejecuta las tareas de mantenimiento de la CLI. Las tareas admin piden tu contraseña. El conjunto exacto puede diferir de la lista Optimize predeterminada de la app Mac. --whitelist permite excluir tareas concretas de futuras ejecuciones.

mo analyze

Mapa de árbol interactivo en el terminal. Navega con las teclas de dirección o atajos Vim (h/j/k/l). Envía archivos a la Papelera directamente desde el mapa. Admite salida --json y rutas personalizadas como mo analyze /Volumes para discos externos.

mo status

Panel de estado en tiempo real: CPU, GPU, memoria, E/S de disco, red, batería, temperatura, tiempo activo, puntuación de salud y procesos principales con gráficas de sesenta segundos. Admite --json para redirigir a otras herramientas.

Comandos exclusivos de la CLI

mo purge

Encuentra artefactos de compilación antiguos en los directorios de proyectos: node_modules, target, .build, build, dist, venv. Escanea rutas configurables (por defecto: ~/Projects, ~/GitHub, ~/dev). Los proyectos con menos de 7 días se marcan como "Reciente" y se deseleccionan por defecto. Admite --dry-run y --paths para configurar los directorios de escaneo.

mo installer

Descubre archivos de instaladores .dmg, .pkg y .zip en Descargas, Escritorio, caché de Homebrew, iCloud y adjuntos de Mail. Etiqueta cada archivo por ubicación de origen. Admite --dry-run.

mo touchid

Habilita Touch ID para comandos sudo. Ejecuta mo touchid enable para configurar, mo touchid disable para revertir. Admite --dry-run.

Comandos de utilidad

mo completion

Configura el autocompletado con tabulador para Bash y Zsh. Autodetecta tu shell y actualiza el archivo de configuración apropiado.

mo update

Autoactualización a la última versión estable. Usa --nightly para la última compilación no publicada de main (solo instalaciones por script). Usa --force para reinstalar la versión actual.

mo remove

Desinstala la CLI de Mole de tu sistema, incluyendo archivos de configuración e integración con el shell. Admite --dry-run.

Seguridad

Tanto la CLI como la app Mac comparten los mismos principios de seguridad:

Protección de rutas. Una lista de denegación integrada cubre directorios críticos del sistema, la estructura esencial de tu carpeta de inicio y cualquier cosa fuera de ubicaciones de caché conocidas. Los enlaces simbólicos se resuelven y validan antes de cualquier operación.

Detección de procesos. Las cachés que pertenecen a apps en ejecución se omiten durante la limpieza. Las cachés del navegador no se tocan mientras el navegador está abierto.

Control de licencia. En la aplicación Mac, cada herramienta destructiva (Limpiar, Desinstalar, Optimizar, Papelera desde Analizar) funciona dos veces gratis. Después se requiere una licencia activa. El escaneo siempre es gratuito.

Lista blanca. Tanto la CLI (~/.config/mole/whitelist) como la app Mac permiten proteger cachés o tareas de optimización específicas de futuras ejecuciones.

Registro de operaciones. Cada eliminación se registra en ~/Library/Logs/mole/operations.log. El panel de Doctor de la app Mac comprueba la salud de este registro y muestra los fallos recientes.

Previsualización primero. La CLI admite --dry-run en cada comando destructivo. La app Mac muestra la lista completa de archivos y el tamaño antes de cualquier acción.

Resolución de problemas

La app Mac incluye un Doctor integrado que detecta problemas habituales. Ábrelo desde Ayuda → Ejecutar Doctor... en la barra de menús. Para condiciones específicas, consulta la página de Ayuda.

Para la CLI, añade --debug a cualquier comando para registros detallados. Revisa el registro de operaciones en ~/Library/Logs/mole/operations.log para la actividad reciente. Si un comando falla silenciosamente, comprueba si el Acceso Completo al Disco está concedido en Ajustes del Sistema.

Para informar de problemas, consulta la sección Informar de un problema en la página de Ayuda.