Mole鼴

1. Descargar y probar

Haz clic en Descargar y probar. Arrastra Mole a Aplicaciones y ejecútalo. Cada herramienta funciona dos veces sin licencia.

2. Comprar una licencia

Desde la página principal, haz clic en el botón de compra. Accederás a la página de pago segura de Dodo Payments.

1. Rellena la Información de contacto: tu nombre, un correo normal que revises directamente y teléfono. La clave de licencia se enviará a ese correo, así que comprueba bien que no haya errores antes de pagar. Las direcciones de Apple iCloud (@icloud.com, @me.com, @mac.com) y las direcciones de reenvío o privacidad (como @duck.com) a menudo filtran o descartan en silencio estos correos; una bandeja de Gmail u Outlook es la más fiable.
2. Rellena la Dirección de facturación: país, ciudad, región, código postal.
3. Haz clic en Continuar al pago.
4. Elige un método de pago: Tarjeta, Apple Pay, Google Pay, WeChat o Cash App.
5. Confirma el pago. La clave de licencia llega a tu bandeja de entrada en segundos.

3. Activar Mole

1. Abre el correo de Dodo Payments y copia la clave de licencia.
2. Abre Mole. Pulsa Cmd + Shift + L (o abre el menú Mole en la barra de menús de macOS y elige Licencia...).
3. Pega la clave y haz clic en Activar. Mole elimina automáticamente espacios y saltos de línea accidentales.
4. Verás Todas las herramientas desbloqueadas. Listo.

El correo con la licencia no llegó

Normalmente llega en segundos. Si no lo ves, revisa tu carpeta de Correo no deseado o Spam y busca Dodo en el buzón. Las direcciones de Apple iCloud (@icloud.com, @me.com, @mac.com) y las direcciones de reenvío a veces lo bloquean por completo. Si después de unos minutos no aparece nada, escribe a hi@mole.fit con tu Payment ID o el correo de compra y te reenviaré la clave, o la enviaré a otra bandeja.

También puedes usar el portal de clientes de Dodo Payments. Introduce el correo usado al pagar, abre el enlace de acceso de un solo uso que envía Dodo y podrás ver el pedido, descargar la factura y encontrar la clave de licencia de Mole asociada a esa compra.

4. Cambiar a un nuevo Mac

Cada licencia funciona en hasta 2 Macs a la vez. Para moverla: abre Mole en la máquina antigua, pulsa Cmd + Shift + L, haz clic en Desactivar. Luego activa en la nueva máquina con la misma clave.

5. Reembolsos y facturas

Si Mole no es lo que esperabas, envía un correo a hi@mole.fit en un plazo de 14 días con tu Payment ID o correo de compra. Consulta la Política de reembolso para las condiciones completas.

Añade en el correo una frase sobre qué fue difícil o no cumplió tus expectativas en Mole. Ayuda a responder más rápido y mejorar el producto.

Dodo Payments genera un recibo automáticamente después de cada compra. Para una factura formal con empresa o datos fiscales, escribe dentro de los 30 días posteriores a la compra.

6. Ajustes y atajos de teclado

Pulsa Cmd + , para abrir Ajustes. Ajustes tiene tres pestañas.

General cubre idioma, abrir al iniciar sesión, ocultar icono del Dock, activación de licencia y gestión de dispositivos, acceso completo al disco.

Mantenimiento cubre modo de eliminación de caché y lista protegida.

Barra de menús controla el monitor de barra de menús, runner o métricas, métricas visibles, comportamiento de ventiladores si está disponible y atajos para Menu Bar Toggle / Keep Screen On / Clean Screen.

Atajos:

• Cmd + , abrir Ajustes
• Cmd + Shift + L abrir panel de Licencia
• Esc cerrar cualquier panel (Ajustes, Licencia, Doctor, paneles de revisión)

7. Consejos para el uso diario

Las secciones anteriores cubren la instalación y la operación. Estas notas te ayudan a ajustar Mole a tu ritmo de trabajo.

Atajos de la barra de menús

Tres atajos globales opcionales están en Ajustes → Barra de menús: Menu Bar Toggle, Keep Screen On y Clean Screen. Ninguno trae valor por defecto; las teclas no se disparan hasta que registres uno. Haz clic en el campo, pulsa la combinación y luego Intro; Mole reemplaza cualquier asignación previa para esa acción.

Selecciones que funcionan bien: ⌘⇧O para Menu Bar Toggle y echar un vistazo a CPU y memoria; una tecla de función o ⌥⇧K para Keep Screen On durante presentaciones o descargas largas; ⌃⌥C para Clean Screen antes de limpiar pantalla y teclado, mejor con bloqueo de entrada.

Frecuencia de Optimize

Optimize omite automáticamente tareas relacionadas cuando hay VPN, teclado o ratón Bluetooth, audio Bluetooth, audio externo o pantalla externa activos. Las tareas omitidas muestran un motivo en la lista de resultados. El reinicio del Dock añade un periodo de enfriamiento de 7 días e indica cuántos días han pasado desde la última ejecución.

Ritmo sugerido: ejecuta Optimize cuando la presión de memoria se mantenga alta o las apps se abran lentamente, no como un hábito diario. Entre ejecuciones, la pestaña Doctor es un punto de control más ligero.

Modo de eliminación de cachés

Permanente (por defecto) libera espacio de inmediato y los resultados de escaneo no se pueden restaurar. Papelera envía todo a la Papelera de macOS, así puedes arrastrar los elementos a su ubicación original si una caché limpiada resulta más importante de lo esperado.

El modo Papelera es una red de seguridad tranquila para las primeras limpiezas o cuando una categoría no es familiar. Abre Documentación → Limpieza para ver qué secciones se limpian automáticamente y cuáles requieren revisión.

8. Ejecutar Doctor dentro de Mole

Desde la barra de menús elige Ayuda -> Ejecutar Doctor.... Mole genera un breve informe sobre tu Mac, permisos, operaciones recientes y entorno. Haz clic en Copiar informe para compartirlo en un chat, o Abrir issue en GitHub para acceder a un formulario de errores con todo prerrellenado.

Falta el Acceso Completo al Disco

Mole necesita Acceso Completo al Disco para escanear las cachés bajo ~/Library y ubicaciones del sistema. Abre Ajustes del Sistema -> Privacidad y Seguridad -> Acceso Completo al Disco, activa Mole y reinicia la aplicación. Mole solo lee de estas ubicaciones; nunca envía contenidos de archivos a ningún sitio.

La presión de memoria es alta

macOS informa de presión de memoria elevada cuando la memoria activa más la memoria comprimida desplazan la caché. Cierra las aplicaciones que no uses (especialmente navegadores con muchas pestañas y herramientas Electron pesadas). La pestaña Estado de Mole lista los procesos principales por CPU y memoria si quieres ver cuáles consumen más.

El disco está casi lleno

Cuando tu disco de arranque supera el 90% de uso, macOS empieza a usar swap y a ralentizarse. Abre la pestaña Limpiar para recuperar cachés, registros y papelera. Para carpetas grandes puntuales, la pestaña Analizar visualiza el espacio por directorio para que puedas localizar lo que más ocupa.

La salud de la batería es baja

Mole muestra este aviso cuando la capacidad máxima baja del 80% o la batería supera los 1000 ciclos de carga. Una batería gastada no se arregla con software: revisa el valor exacto en Ajustes del Sistema -> Batería -> Salud de la batería y reserva servicio con Apple si la autonomía ya no aguanta. La pestaña Estado mantiene visible la misma lectura.

El registro de operaciones de Mole no se puede escribir

Mole escribe un registro por operación en ~/Library/Logs/mole/operations.log. Si el disco está lleno o ese directorio no tiene permisos de escritura, el registro falla silenciosamente. Libera algo de espacio, cierra y vuelve a abrir Mole; el informe de Doctor se pondrá en verde en la siguiente ejecución.

Operaciones recientes fallidas

Un fallo suele significar que una ruta dentro de un lote de limpieza o desinstalación estaba protegida por macOS, bloqueada por otra aplicación o ya había desaparecido cuando Mole la alcanzó. Abre la pestaña donde ocurrió el fallo (Limpiar, Desinstalar, Optimizar) e inspecciona el panel de detalles; cada fila fallida incluye un motivo.

9. Informar de un problema

Antes de abrir nada, revisa los issues abiertos primero; alguien puede haber encontrado lo mismo.

Error o cuelgue de la app Mac

Ejecuta Doctor primero (sección 8 arriba). Haz clic en Abrir issue en GitHub en el panel de Doctor para acceder a un formulario de errores con tu informe del sistema prerrellenado. Si prefieres hacerlo manualmente, copia el informe y pégalo en el formulario.

Mole se queda congelado o girando

No fuerces el cierre todavía. Mientras Mole siga bloqueado, abre la Terminal, pega el siguiente comando y pulsa Retorno: curl -fsSL https://mole.fit/downloads/Mole-Diagnose.command | bash Ejecutarlo desde la Terminal evita el bloqueo «Apple no pudo verificar» de macOS. Crea un zip en el Escritorio con muestras del proceso, logs recientes de Mole e informes de crash. Puedes revisar la carpeta antes de compartirla.

Idea de funcionalidad para la app Mac

Abre el formulario de solicitud de funcionalidades. Describe el problema que resolvería la funcionalidad, no solo la funcionalidad en sí.

Error o sugerencia para la CLI

La CLI de Mole es un proyecto de código abierto independiente. Abre issues específicos de la CLI en el rastreador de issues de la CLI. Incluye tu versión de macOS y la salida de mo version.

Licencia, pago, reembolso o datos privados

Envía un correo a hi@mole.fit con el correo de compra, Payment ID y hora aproximada del pago.

Resumen

Mole tiene dos interfaces con el mismo alcance de limpieza, reglas de seguridad y listas de protección. La CLI es gratuita, open source y con licencia MIT. 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. Usa ejecución nativa para los flujos de Mac; 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 revisión por defecto: cachés de paquetes con coste real de reconstrucción (npm, yarn, pnpm, bun, CocoaPods, Gradle, Maven) y salidas comunes de proyecto (build, dist, target, .build, node_modules, venv). Estas carpetas pueden ser grandes y quedan sin marcar hasta que confirmes. Las entradas automáticas llegan marcadas; en Ajustes puedes enviar todo a la Papelera.

Software (Mars)

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.

Optimize (Mercury)

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.

Status (Sun)

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 cuadricula 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.

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 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. Haz clic en Copiar informe para pegarlo en un chat, o Abrir issue en GitHub para acceder a un formulario de errores con el informe prerrellenado.

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 más de quince categorías de residuos 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 la completación por 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.