203 ·GitHub
What is this?
Disk Raccoon (硬盘小浣熊) is an AI skill that helps your coding agent find macOS cache folders eating up disk space, figure out which ones are safe to delete, and clean them for you.
Disk Raccoon (硬盘小浣熊) is an AI skill that helps your coding agent find macOS cache folders eating up disk space, figure out which ones are safe to delete, and clean them for you.Is this a standalone cleaning app, or something I add to my AI agent?It is a SKILL.md-based skill, not a standalone app. You load it into an AI agent that supports the SKILL.md protocol, such as Claude Code, and the agent does the analysis and cleanup.
It is a SKILL.md-based skill, not a standalone app. You load it into an AI agent that supports the SKILL.md protocol, such as Claude Code, and the agent does the analysis and cleanup.How do I use it?Install it as a skill in a SKILL.md-compatible agent, then just ask in plain language like 'help me check my cache' or 'disk is full, what can I clean', and the agent walks the cache map and reports back.
Install it as a skill in a SKILL.md-compatible agent, then just ask in plain language like 'help me check my cache' or 'disk is full, what can I clean', and the agent walks the cache map and reports back.Which AI agents can run this skill?Any agent that supports the SKILL.md protocol; the README names Claude Code and Cola as examples.
Any agent that supports the SKILL.md protocol; the README names Claude Code and Cola as examples.Does it delete files automatically without asking?No - the first pass is read-only and only produces a report. Paths not yet classified in the cache map are left untouched until verified, and anything needing sudo only gets a command printed for you to run yourself.
No - the first pass is read-only and only produces a report. Paths not yet classified in the cache map are left untouched until verified, and anything needing sudo only gets a command printed for you to run yourself.How does the cache map work?It is a living reference file (references/cache-map.md) where every known cache path is tagged with a safety level: safe to delete, delete with care, or never touch. Unknown paths get investigated before any action is taken.
It is a living reference file (references/cache-map.md) where every known cache path is tagged with a safety level: safe to delete, delete with care, or never touch. Unknown paths get investigated before any action is taken.Why is it called a raccoon?Raccoons are famous for washing food before eating it - the project applies that same check-before-you-touch caution to cache cleanup instead of blindly deleting whatever is largest.
Raccoons are famous for washing food before eating it - the project applies that same check-before-you-touch caution to cache cleanup instead of blindly deleting whatever is largest.What has it actually cleaned so far?In its first real run it freed over 135GB: about 56GB from the uv Python package cache, 51GB from Chrome's Service Worker and debug cache, and 38GB from Feishu's LarkShell document cache.
In its first real run it freed over 135GB: about 56GB from the uv Python package cache, 51GB from Chrome's Service Worker and debug cache, and 38GB from Feishu's LarkShell document cache.What are similar projects?macos-sysdata, PureMac, replica-skill, linkedin-agent-skill, i-have-adhd, jev-browser-use, ai-aug-edu, shuohao-skills
macos-sysdata, PureMac, replica-skill, linkedin-agent-skill, i-have-adhd, jev-browser-use, ai-aug-edu, shuohao-skillsWhich topics is it in?disk-space, cleaner, system-cleaner, storage, claude-code-skill, skill, utility, claude, markdown, ai-agent, agent-skills, productivity
disk-space, cleaner, system-cleaner, storage, claude-code-skill, skill, utility, claude, markdown, ai-agent, agent-skills, productivity