# Mole for Raycast

URL: https://www.raycast.com/jlrochin/mole

> Clean and optimize your Mac with Mole: free disk space, uninstall apps, remove node_modules and installers, analyze disk usage and monitor system health.

- Install: raycast://extensions/jlrochin/mole
- Author: [jlrochin](https://www.raycast.com/jlrochin)
- Installs: 24,877
- Platforms: macOS
- Categories: System, AI Extensions
- Updated: 2026-11-17
- Source: https://github.com/raycast/extensions/tree/459326f4f557692a79246dba2d013746f56d724b/extensions/mole/

## Commands

- **System Status**: View real-time system health, CPU, memory, disk, battery, and network status
- **Clean System**: Preview and remove caches, logs, and temporary files to free up disk space
- **Optimize System**: Rebuild databases, refresh services, and optimize system performance
- **Uninstall App**: Uninstall apps and clean residual files from Library, Caches, and Preferences
- **Purge Dev Artifacts**: Find and remove old build artifacts like node_modules, .next, dist, and target folders
- **Analyze Disk**: Browse folders sorted by size to find what's using your disk space
- **Clean Installers**: Find and remove installer files (.dmg, .pkg, .iso) from Downloads, Desktop, and Documents
- **Touch ID for Sudo**: Configure Touch ID for sudo authentication
- **Update Mole**: Update Mole to the latest version
- **Health Menu Bar**: Show system health score in the menu bar

## AI tools

- **Open Cleanup Command**: Open a Mole cleanup command from AI. The command previews what it will change and asks for confirmation before removing files. Use clean for system caches and logs, purge for development build artifacts, installer for downloaded installer files, uninstall for an app and its residual files, or optimize for system maintenance.

## README

<p align="center">
  <img src="https://github.com/raycast/extensions/raw/459326f4f557692a79246dba2d013746f56d724b/extensions/mole//assets/extension-icon.png" width="128" height="128" alt="Mole" />
</p>

<h1 align="center">Mole</h1>

<p align="center">
  Deep clean and optimize your Mac from Raycast.
  <br />
  A Raycast extension for <a href="https://github.com/tw93/mole">Mole</a>, the macOS system maintenance CLI.
</p>

#### Screenshots

|           System Status            |           Clean System            |
| :--------------------------------: | :-------------------------------: |
| ![System Status](https://github.com/raycast/extensions/raw/459326f4f557692a79246dba2d013746f56d724b/extensions/mole//media/mole-1.png) | ![Clean System](https://github.com/raycast/extensions/raw/459326f4f557692a79246dba2d013746f56d724b/extensions/mole//media/mole-2.png) |

|           Analyze Disk            |           Optimize System            |
| :-------------------------------: | :----------------------------------: |
| ![Analyze Disk](https://github.com/raycast/extensions/raw/459326f4f557692a79246dba2d013746f56d724b/extensions/mole//media/mole-3.png) | ![Optimize System](https://github.com/raycast/extensions/raw/459326f4f557692a79246dba2d013746f56d724b/extensions/mole//media/mole-4.png) |

#### Prerequisites

Mole (`mo`) must be installed on your system:

```bash
brew install mole
```

#### Commands

| Command                 | Description                                                                       |
| ----------------------- | --------------------------------------------------------------------------------- |
| **System Status**       | Real-time dashboard with health score, CPU, memory, disk, battery, and network    |
| **Clean System**        | Preview and remove caches, logs, and temporary files with streaming progress      |
| **Optimize System**     | Rebuild databases, refresh services, and optimize system performance              |
| **Uninstall App**       | Browse installed applications and move them to the Trash                          |
| **Analyze Disk**        | Browse folders sorted by size with drill-down navigation                          |
| **Purge Dev Artifacts** | Find and remove old node_modules, .next, dist, target, and venv folders           |
| **Clean Installers**    | Find and remove .dmg, .pkg, and .iso files from Downloads, Desktop, and Documents |
| **Touch ID for Sudo**   | Check status and toggle Touch ID for sudo authentication                          |
| **Update Mole**         | Update Mole to the latest version                                                 |
| **Health Menu Bar**     | Show system health score in the menu bar with CPU, RAM, disk, and battery summary  |

Raycast AI adds **Ask Mole** when this extension is installed. Ask it to open Clean System, Purge Dev Artifacts, Clean Installers, Uninstall App, or Optimize System. Review the command's preview and confirm the action in Raycast.

#### Configuration

| Preference       | Scope         | Description                                                |
| ---------------- | ------------- | ---------------------------------------------------------- |
| Mole Binary Path | Extension     | Custom path to the `mo` binary (auto-detected by default)  |
| Refresh Interval | System Status | How often to refresh status data (3, 5, 10, or 30 seconds) |
| Default Path     | Analyze Disk  | Starting directory for disk analysis                       |
| Refresh Interval | Health Menu Bar | How often to refresh the health score in the menu bar    |

#### Credits

This extension is a Raycast interface for [Mole](https://github.com/tw93/mole), created by [tw93](https://github.com/tw93). All system maintenance operations are powered by the Mole CLI. This extension is not affiliated with or endorsed by the original project.
