ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

storage-cleanup

One-command disk cleanup for macOS and Linux — trash, caches, temp files, old kernels, snap revisions, Homebrew, Docker, and Xcode artifacts. Use when user asks to free storage, clean up disk, reclaim space, reduce disk usage, or encounters low disk / "disk full" warnings. Safe by default with dry-run mode. No dependencies beyond bash and awk.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/camopel/storage-cleanup
Or

Storage Cleanup

Reclaim tens of gigabytes in one command. No config files, no dependencies, no damage.

Why This Skill

Systems accumulate junk silently — IDE caches, old snap revisions, stale pip builds, forgotten trash, outdated kernels. Manually hunting them down wastes time and risks deleting the wrong thing.

This skill:

  • Scans 12+ cleanup targets across both macOS and Linux in a single pass
  • Safe by default--dry-run shows exactly what would be cleaned before touching anything
  • Zero dependencies — pure bash + awk, works on any stock macOS or Linux install
  • Cross-platform — auto-detects OS and runs only what applies (no errors on missing tools)
  • Selective — skip any category with --skip-kernels, --skip-docker, --skip-brew, --skip-snap
  • Reports savings — shows before/after disk usage and exact bytes freed

Quick Start

# Preview what would be cleaned (safe, changes nothing)
bash scripts/cleanup.sh --dry-run

# Clean everything
bash scripts/cleanup.sh --yes

# Clean but keep Docker and old kernels
bash scripts/cleanup.sh --yes --skip-docker --skip-kernels

What Gets Cleaned

Both Platforms

TargetTypical SizeNotes
Trash1–50 GBmacOS ~/.Trash, Linux ~/.local/share/Trash
Stale /tmp1–10 GBpip/npm/rust build dirs older than 60 min
pip cache50–500 MBpip cache purge
Go build cache100 MB–2 GBgo clean -cache
pnpm / yarn / node caches50–500 MBSafe to regenerate
JetBrains IDE cache1–10 GBIntelliJ, PyCharm, WebStorm, etc.
Whisper model cache1–5 GBRedownloads on demand
Chrome / Firefox cache200 MB–2 GBBrowsing cache only
Playwright browsers200 MB–1 GBRedownloads on demand
Docker dangling images0–10 GBOnly unreferenced images + build cache

Linux Only

TargetTypical SizeNotes
Apt cache200 MB–2 GBapt clean
Journal logs500 MB–4 GBVacuumed to 200 MB
Disabled snap revisions500 MB–5 GBOld versions kept by snapd
Old kernels200–800 MBKeeps current running kernel

macOS Only

TargetTypical SizeNotes
Homebrew old versions500 MB–5 GBbrew cleanup --prune=7
Xcode DerivedData2–30 GBBuild artifacts, safe to clear
Xcode Archives1–20 GBOld build archives
iOS DeviceSupport2–15 GBOld device symbols
CoreSimulator caches500 MB–5 GBSimulator disk images
Old user logs100 MB–1 GBLogs older than 30 days

Options

FlagEffect
--dry-runPreview cleanup without deleting anything
--yes / -yRun without confirmation prompts
--skip-kernelsDon't remove old kernels (Linux)
--skip-snapDon't remove disabled snap revisions (Linux)
--skip-dockerDon't prune Docker
--skip-brewDon't clean Homebrew

Metadata

Author@camopel
Stars4072
Views0
Updated2026-04-13
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-camopel-storage-cleanup": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

ddgs-search

Free multi-engine web search via ddgs CLI (DuckDuckGo, Google, Bing, Brave, Yandex, Yahoo, Wikipedia) + arXiv API search. No API keys required. Use when user needs web search, research paper discovery, or when other skills need a search backend. Drop-in replacement for web-search-plus.

camopel 4072

finviz-crawler

Continuous financial news crawler for finviz.com with SQLite storage, article extraction, and query tool. Use when monitoring financial markets, building news digests, or needing a local financial news database. Runs as a background daemon or systemd service.

camopel 4072

arxivkb

Local arXiv paper manager with semantic search. Crawls arXiv categories, downloads PDFs, chunks content, and indexes with FAISS + Ollama embeddings. No cloud API keys required — everything runs locally.

camopel 4072

privateapp

Personal PWA dashboard server with plugin apps. Use when: (1) installing or setting up PrivateApp, (2) starting/stopping/restarting the service, (3) building frontends after changes, (4) adding new app plugins, (5) configuring push notifications. Requires Python 3.9+, Node.js 18+. Runs as systemd user service or launchd plist.

camopel 4072

claw-guard

System-level watchdog for OpenClaw gateway restarts and sub-agent task PIDs. Monitors registered PIDs and optional log/directory freshness. Auto-reverts config on failed gateway restarts. Requires explicit registration — does NOT auto-discover. Use when running long background tasks or before gateway restarts.

camopel 4072