disk-cleanup
/disk-cleanup
Skanuje i czyści cache macOS, dane menedżerów pakietów, zrzuty awarii i cache aplikacji, aby odzyskać miejsce, za pomocą rejestru targets.json oraz skryptów survey.py i clean.py.
- Autor
- glebis ↗
- Repozytorium
- claude-skills ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 25.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 10
- Skrypty
- 4
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 4 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/clean.py, scripts/lib.py, scripts/survey.py, scripts/tests/test_safety.py
Co robi i kiedy
Skanuje i czyści cache macOS, dane menedżerów pakietów, zrzuty awarii i cache aplikacji, aby odzyskać miejsce, za pomocą rejestru targets.json oraz skryptów survey.py i clean.py.
Wyzwalacze z opisu
Oryginalny opis (EN)
Scan and clean macOS caches, package-manager data, crash dumps, and app caches to reclaim disk space. Deterministic — a config registry (targets.json) plus two scripts (survey.py read-only, clean.py executor) do all the measuring and deleting; the agent only relays a compressed summary and makes the few human-judgment calls. IMPORTANT — use this skill whenever the user's request on macOS involves: freeing disk space, cleaning/clearing caches, "disk is full", "clean up my Mac", "free up space", "what's eating my disk", "running low on disk", needing space for an install, or any low-storage comp
Jak działa
- The two scripts
- Safety model (enforced in code, not prose)
- Agent workflow
- Maintaining the registry
- Customization & setup (per-machine, never committed)
- Still agent-driven (only what genuinely can't be deterministic)
Podgląd SKILL.md
---
name: disk-cleanup
description: Scan and clean macOS caches, package-manager data, crash dumps, and app caches to reclaim disk space. Deterministic — a config registry (targets.json) plus two scripts (survey.py read-only, clean.py executor) do all the measuring and deleting; the agent only relays a compressed summary and makes the few human-judgment calls. IMPORTANT — use this skill whenever the user's request on macOS involves: freeing disk space, cleaning/clearing caches, "disk is full", "clean up my Mac", "free up space", "what's eating my disk", "running low on disk", needing space for an install, or any low-storage complaint. Covers the whole workflow survey → choose → clean → empty Trash.
---
# Disk Cleanup
**Deterministic by design.** All target knowledge lives in `targets.json`; all measuring and
deleting lives in `scripts/survey.py` (read-only) and `scripts/clean.py` (executor, **dry-run by
default**). They run headless with **zero dependencies** (stdlib only) — a user can run them in a
terminal without any agent. The agent's job is small: run the scripts, relay the compressed
output, and decide the handful of things that need human judgment.
## The two scripts
```bash
python3 scripts/survey.py # read-only: sizes, risk, flags, uncategorized. Touches nothing.
python3 scripts/survey.py --json # same, machine-readable (preferred for the agent)
python3 scripts/clean.py --preset safe # DRY-RUN plan (default — nothing deleted)
python3 scripts/clean.py --preset safe --go # execute (safe risk only)
python3 scripts/clean.py --preset full --allow-medium --go --empty-trash # safe+medium, then empty Trash
python3 scripts/clean.py --ids cargo-registry-cache,go-mod-cache --go # specific targets
python3 scripts/clean.py --preset safe --skip ollama-models --go # exclude one
```
`trash` is used for all file removal (never `rm`); freed space sits in Trash until emptied
(`--empty-trash`, or the user empties it). Sizes are `du` estimates — approximate on APFS.
## Safety model (enforced in code, not prose)
- **Risk gating:** `safe` runs automatically; `medium` needs `--allow-medium`; `never` is
refused even if named by id. `advisory` targets only print guidance, never execute.
- **Preflight on every trashed path:** canonical `realpath` → must resolve under an
`allowed_roots` entry → must not be a symlink → never `$HOME` or `/`. Anything failing is
skipped and reported, not deleted.
- **Dry-run by default:** `clean.py` prints the plan and touches nothing unless `--go`.
## Agent workflow
1. Run `python3 scripts/survey.py --json`. Relay the **compressed** summary: disk free,
`safe`/`medium` recoverable totals, any `flags` (e.g. crash-loop), and the top targets.
Do not dump the whole JSON.
2. **Auto-path:** for a plain "clean up safe stuff", show the `safe` total and run
`clean.py --preset safe --go` (offer `--empty-trash`). Safe targets are regenerable.
3. **Escalate to the user ONLY for** (these are genuine judgment calls the scripts deliberately
refuse to auto-decide):
- `medium` targets (ML models, device support, project `node_modules`) — confirm before `--allow-medium`.
ML-model targets (`ollama-models`, `huggingface-models`) carry a `last_used_days` field
(newest file atime under the target, aggregate across all models in that store — not
per-model) as a "how stale is this" signal; surface it before suggesting deletion.
- `uncategorized` discoveries — unknown dirs >100 MB; ask or investigate before adding.
- `advisory` notes — surface them (Telegram cache, simulators via `simctl`, `uv/tools`,
Chrome whole-dir, Xcode Archives, `mo clean` deep-clean); never act on them automatically.
For `mole-deep-clean`: suggest the user run `mo clean` themselves (interactive TUI, permanent
deletes, sudo for system caches) — never invoke it from the agent. **Never shell out to `mo`
at all** (not even `--dry-run`): it's TUI-only and blocks waiting for a real terminal even in
dry-run mode — confirmed hanging under a piped subprocess, `stdin=DEVNULL`, and even a
`script(1)`-allocated pty. A `mole` flag in survey.py's output only reads the mtime of
mole's own leftover `~/.config/mole/clean-list.txt` (last-run recency), never invokes it.
- surgical Docker / simulator decisions (see below).
4. Run `clean.py` with the resolved selection. Relay the result (`freed_human`, disk before→after).
## Maintaining the registry
Add or correct targets by editing `targets.json` — no code change needed. Each target:
`{id, category, risk, method, paths|find, regenerates, priority, note}`. Methods:
- `trash` — trash literal paths (globs allowed).
- `find-trash` — exact-name dir sweep with a `min_mb` floor (crash dumps, project `node_modules`).
- `command` — run a CLI (`npm cache clean`…); set `scope_path` so freed bytes can be measured.
- `simctl` — `xcrun simctl delete unavailable` (removes only sims for uninstalled runtimes; safe).
- `downloads-scan` — config-driven (`config.json` → `downloads_scan`): files older than `age_days`
whose name doesn't match `exclude_patterns`. The dry-run **lists every file by name** for review.
- `advisory` — never executes; only prints guidance.
Keep installed software at `risk: never` (learned the hard way: `uv/tools`, `uv/python`,
`~/.rustup/toolchains`, `~/.bun`, `~/.deno` are NOT caches). Every non-advisory target's paths
must resolve under `allowed_roots` or preflight will (correctly) refuse them.
## Customization & setup (per-machine, never committed)
`config.json` ships **generic, public-safe defaults**. Anything personal — names, family
names, a non-English tax/legal/financial vocabulary — or machine-specific goes in
**`config.local.json`** (gitignored). `load_config()` deep-merges it over `config.json`:
**lists are unioned** (local terms only *add* protection to the Downloads exclude list), scalars
override. See `config.local.example.json` for the shape.
**Setup mode** — when the user first uses the skill, asks to personalize it, or has sensitive
files in `~/Downloads`, offer to build `config.local.json` by asking (one short batch):
1. Names/keywords in Downloads filenames that must **never** be swept (own name, family names).
2. Their language's tax/legal/financial terms (e.g. German `steuer`, `rechnung`, `vertrag`).
3. Their projects directory (for the `node_modules` sweep) and any extra app caches.
Then write `config.local.json` (copy `config.local.example.json` and fill it in). Confirm what
was saved. Never commit it.
Per-machine paths in `targets.json` (`allowed_roots`, the `node-modules-projects` find root
`~/ai_projects`) are examples — adjust them to the user's layout. Targets whose paths don't
exist on this machine simply measure 0 and are skipped.
## Still agent-driven (only what genuinely can't be deterministic)
- **Docker only** — surgical and stateful: survey with `docker images` / `docker ps -as` /
`docker system df -v`, let the user pick per-name (`docker rm`/`rmi`/`volume rm`/`builder prune`),
or blunt `docker system prune -a -f`. A named volume removed = data gone; confirm by name.
(Everything else — simulators via the `simctl` method, Downloads via `downloads-scan`,
crash dumps, all caches — now runs through the scripts.)
Pliki w paczce (10)
- .gitignore 1 KB
- SKILL.md 7 KB
- config.json 1 KB
- config.local.example.json 1 KB
- targets.json 11 KB
- .claude-plugin/plugin.json 1 KB
- scripts/clean.py 8 KB
- scripts/lib.py 10 KB
- scripts/survey.py 5 KB
- scripts/tests/test_safety.py 3 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · glebis/claude-skills | 100 | MIT |
| yonatangross/orchestkit | 100 | MIT |
| inline-chat/inline | 100 | AGPL-3.0 |
| hakula139/plugins | 100 | MIT |
| moonlight-lupin/agent-skills | 100 | MIT |
| mtarcure/claude-vibe-squad | 100 | MIT |
| DaraBoth/skilljmskill | 98 | MIT |
| sasugadayo/disk-cleanup-skill | 98 | MIT |
| SamueleGuerrini/disk-cleanup-skill | 93 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki dee2f7f8f488 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100safe-macos-cleanup
Bezpiecznie czyści miejsce na dysku macOS według dowodów: cache, pliki tymczasowe i logi, dane systemowe, lokalne migawki Time Machine i cache deweloperskie, bez usuwania projektów i sekretów. - 100mac-software-storage-cleanup
Audytuje zajętość dysku przez aplikacje na macOS, czyści priorytetowe cache i wskazuje miejsce, które można odzyskać. - 100computer-clean
Audytuje i odzyskuje miejsce na dysku macOS: cache, cache narzędzi deweloperskich, dane martwych aplikacji, stare pobrania, duplikaty instalatorów, nieużywane obrazy kontenerów i stare katalogi node_modules oraz .venv. - 100mac-storage-cleaner
Bezpiecznie odzyskuje miejsce na dysku Maca w przejrzysty i odwracalny sposób: czyści cache, usuwa pozostałości po odinstalowanych aplikacjach i wskazuje, co zajmuje dysk. - 90free-up-disk-space
Zwalnia miejsce na dysku Maca bezpiecznie: pokazuje, co zajmuje przestrzeń, czyści pamięci podręczne i symulatory oraz ocenia, czy folder można usunąć. - 100yc-disk-cleanup
Zwalnia miejsce na dysku komputera deweloperskiego bez utraty danych, pytając o każdą pozycję przed usunięciem.