Skip to main content
skill CX Codex

mole — Claude Code skill for disk cleanup

This Claude Code skill operates Mole CLI on macOS and Windows. It checks disk usage, previews cleanup actions, and reads system status and cleanup history.

GPL-3.0 1,600 installs ★ 75,794 updated 2026-11-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add tw93/Mole --skill mole -a claude-code
Open on GitHub

What mole does

The skill runs Mole (mo) commands to inspect disk usage, check system health, review cleanup history, and list apps for removal. It reads command output first and presents a preview with sizes and the affected groups before any cleanup.

Removal requires approval after the preview. Cleanup commands do not offer item-by-item selection, while app removal and administrator-level actions must be completed in the user’s terminal. Mole CLI (mo) and a local shell on macOS or Windows are required. The skill is for operating Mole, not changing its source code.

What it helps with

  • identify what is taking up disk space
  • preview the items and sizes targeted by cleanup
  • check Mole’s cleanup history
  • find an app in Mole’s uninstall list

Example prompts for the agent

  • Show what is using disk space and preview the cleanup plan.
  • Check what Mole removed earlier.
  • Find an app in the uninstall list and tell me what to run in my terminal.

How to install mole

1Skills CLI (Vercel)

npx skills add tw93/Mole --skill mole -a claude-code

2Manually: put the files in place

~/.claude/skills/mole/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/mole/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about mole

How do I install mole in Claude Code?

Run npx skills add tw93/Mole --skill mole -a claude-code. The skill file is at ~/.claude/skills/mole/SKILL.md.

What does mole do?

It operates Mole CLI to inspect disk usage, view cleanup previews and history, and list apps for removal. Cleanup requires approval after the preview.

What does mole need to run?

It requires Mole CLI (mo) and a local shell on macOS or Windows. App removal and administrator-level actions must be run in the user’s terminal.

Similar skills

SKILL.md skills catalog →

Project sponsors

Companies that keep this analytics open