AI agent plugin for disk scanning, analysis, and cleanup. Requires macOS.
Teaches AI agents how to use diskcopilot-cli — a fast disk scanner (~12s for a home directory) that caches filesystem metadata in SQLite, letting the agent write SQL to answer any disk space question.
Ask your agent things like:
- "What's taking up space on my Mac?"
- "How big are my node_modules?"
- "Help me free up 10GB"
claude plugin marketplace add diskcopilot/diskcopilot-skills
claude plugin install diskcopilotThe plugin will automatically install the diskcopilot-cli binary on first use.
One-line install — works with any agent that supports the Agent Skills standard:
mkdir -p ~/.agents/skills/diskcopilot && curl -fsSL https://raw.githubusercontent.com/diskcopilot/diskcopilot-skills/main/skills/diskcopilot/SKILL.md -o ~/.agents/skills/diskcopilot/SKILL.mdThe skill includes auto-install instructions for the CLI binary — no manual setup needed.
| Command | What it does |
|---|---|
/diskcopilot:scan |
Scan a directory (or cwd) and cache metadata |
/diskcopilot:cleanup |
Analyze + open browser dashboard to select and trash items |
/diskcopilot:report |
Analyze + show report in conversation |
diskcopilot-cli only reads filesystem metadata (names, sizes, timestamps). It has no network dependencies and never sends data anywhere. The interactive cleanup UI runs on localhost with a per-session auth token. See diskcopilot-cli for details.
MIT