RepoPilot

tw93 / mole

Search tw93/mole

GitHub

Get started

Taken from the repository's own files on 23 Oct 2026. RepoPilot has not run these commands.

Prerequisites

Commands

Makefile
TaskRunWhat it runs
buildmake build@echo "Building for local architecture..." && $(GO) build -ldflags="$(LDFLAGS)" -o $(BIN_DIR)/$(ANALYZE)-go $(ANALYZE_SRC) && $(GO) build -ldflags="$(LDFLAGS)" -o $(BIN_DIR)/$(STATUS)-go $(STATUS_SRC)
testmake testMOLE_TEST_NO_AUTH=1 ./scripts/test.sh
checkmake check./scripts/check.sh --no-format

Install and use

README.md

Mole requires macOS 12 or newer and supports both Intel and Apple Silicon Macs. If Homebrew no longer supports your macOS version, use the script install instead.

Install via Homebrew

brew install mole

Or via script

curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash

With an AI agent

Tell your agent:

Install Mole for me by reading https://raw.githubusercontent.com/tw93/Mole/main/llms.txt

Or install the skill yourself. With it, Claude Code, Codex, Cursor and other agents show every cleanup with --dry-run before anything is removed, and leave app uninstalls and administrator steps to you. Update with npx skills update -g -y.

npx skills add tw93/Mole -a claude-code codex cursor -g -y

As a host plugin: /plugin marketplace add tw93/Mole then /plugin install mole@mole in Claude Code, or codex plugin marketplace add tw93/Mole then codex plugin add mole@mole in Codex.

Run

mo                           # Interactive menu
mo clean                     # Deep cleanup + already-uninstalled app leftovers
mo uninstall                 # Remove installed apps + their leftovers
mo optimize                  # Refresh caches & services
mo analyze                   # Visual disk explorer (or 'mo analyse')
mo status                    # Live system health dashboard
mo purge                     # Clean project build artifacts
mo installer                 # Find and remove installer files
mo slim                      # Remove Intel code from universal apps

mo touchid                   # Configure Touch ID for sudo
mo completion                # Set up shell tab completion
mo update                    # Update Mole
mo update --nightly          # Update to latest unreleased main build, script install only
mo remove                    # Remove Mole from system
mo --help                    # Show help
mo --version                 # Show installed version

Preview safely

mo clean --dry-run
mo uninstall --dry-run
mo optimize --dry-run
mo purge --dry-run
mo installer --dry-run
mo slim --dry-run
mo history
mo history --json

mo clean --dry-run --debug   # Preview + detailed logs
mo optimize --whitelist      # Manage protected optimization rules
mo clean --whitelist         # Manage protected caches
mo purge --paths             # Configure project scan directories
mo analyze /Volumes          # Analyze external drives only
mo analyze /private/tmp      # Review user-owned temporary directories

Read the rest of README.md

Developing

CONTRIBUTING.md

Run quality checks before committing (auto-formats code):

./scripts/check.sh

Run tests:

./scripts/test.sh

Open CONTRIBUTING.md