cleanup
/cleanup
Odzyskuje miejsce na dysku i czyści gałęzie po agentach kodujących AI: worktrees, scalone gałęzie, artefakty buildów, cache pakietów i stare logi sesji.
- Autor
- davepoon ↗
- Repozytorium
- buildwithclaude ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 25.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 3
- Skrypty
- 1
- 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.
- 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/agent_cleanup.py
Co robi i kiedy
Odzyskuje miejsce na dysku i czyści gałęzie po agentach kodujących AI: worktrees, scalone gałęzie, artefakty buildów, cache pakietów i stare logi sesji.
Oryginalny opis (EN)
Reclaim disk space and prune branches left behind by AI coding agents - merged or abandoned git worktrees, merged branches, stale build artifacts (node_modules, .venv, target), old archives and backups, package caches, and old agent session logs. Use when the user runs /cleanup, says the disk is full, or asks to clean up worktrees, branches, or storage.
Jak działa
- 1. Scope
- 2. Scan
- 3. One confirmation
- 4. Apply
- 5. Report
Podgląd SKILL.md
--- name: cleanup description: Reclaim disk space and prune branches left behind by AI coding agents - merged or abandoned git worktrees, merged branches, stale build artifacts (node_modules, .venv, target), old archives and backups, package caches, and old agent session logs. Use when the user runs /cleanup, says the disk is full, or asks to clean up worktrees, branches, or storage. category: development-code license: MIT --- # Cleanup Free disk space and prune branches with one scan, one confirmation, and one apply. Every deletion goes through `scripts/agent_cleanup.py` in this skill's directory. Right before acting, it re-checks each git item, artifact folder, archive and the trash, and skips anything that changed since the scan. ## 1. Scope Choose what to scan: - **This repo** (default): run from inside it with no `--root`. The scan covers this repo, the agent worktree folders (Codex, Cursor, Conductor, Vibe Kanban), package caches, agent logs and the trash. - **Whole machine**: the user says disk full, all projects, or everything. Add `--root <dir>` for each folder that holds their projects. Look for the usual ones (`~/code`, `~/dev`, `~/src`, `~/projects`, `~/repos`, `~/Developer`, `~/Documents/*`). If none of them exist, ask the user. Narrow with `--only git,artifacts,archives,caches,agents,trash` when the user asks for one kind, e.g. "just branches" → `--only git`. Add `--remote` only when the user wants merged branches deleted on `origin` too. Done when the scan command is chosen. ## 2. Scan ``` python3 <skill-dir>/scripts/agent_cleanup.py scan --fetch [--root DIR ...] [--only ...] [--remote] ``` The scan is read-only, apart from `--fetch` updating remote-tracking refs. It prints numbered items in four classes and saves the plan: - `REMOVE`: merged into the base branch, regenerable, or a worktree whose directory is already gone (unregistering it keeps its branch). - `NEEDS-DECISION`: holds something unique (uncommitted or ignored files, unmerged or unpushed commits, build output, archives, old logs). - `KEEP-ACTIVE` and `SKIP`: open PRs, recent work, long-lived branches, the main checkout, locked or rebasing worktrees, anything a running process is inside, unmounted drives. Never act on these. `--help` lists the thresholds (`--stale-days`, `--keep-days`, `--min-size`). Done when the plan is printed with its reclaimable total. ## 3. One confirmation Ask once, using your multi-select question tool if you have one, otherwise a single message, then wait for the answer: - **REMOVE**, pre-selected, one line per item: id, size, path and note. When there are many, group lines by kind (worktrees, branches, artifacts, caches) and keep each id visible. Say that caches re-download on demand and artifacts come back on the next install or build. - **Each NEEDS-DECISION item** on its own line, unselected: path, size, and what is unique in it (the note). Agent logs and archives cannot be recovered once deleted. - **Remote branches**, if `--remote` was used, as a separate question: deleting them affects everyone using the repo. KEEP-ACTIVE and SKIP get one summary line so the user knows they were seen. Done when the user has answered. ## 4. Apply Pass exactly the ids the user picked: ``` python3 <skill-dir>/scripts/agent_cleanup.py apply 1 2 5 9-14 ``` Add `--remote` only when the picked ids include remote branches the user approved in their own question. `apply --recommended` takes every REMOVE item; use it only when the user approved all of them and nothing else. `apply` prints one line per item: done, skipped (changed since the scan, gone, or now in use), refused, or failed with git's reason. Report each one as printed. Leave skipped and refused items in place; the next scan classifies them again. If the plan is more than 24 hours old, `apply` refuses it: scan again and confirm again. `git worktree remove` refuses a worktree with uncommitted changes. Add `--force` only for ids where the user explicitly accepted losing those changes. A detached worktree's unique commits are saved under `refs/agent-cleanup/` before removal. Done when every picked id has a result line. ## 5. Report Tell the user: - how much space was freed; - what was removed; - what was left and why; - for each `agent-data` item, the agent's built-in retention setting named in its note, so the logs stop piling up. Every action is logged to `~/.local/state/agent-cleanup/history.jsonl`.
Pliki w paczce (3)
- LICENSE 1 KB
- SKILL.md 4 KB
- scripts/agent_cleanup.py 52 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · davepoon/buildwithclaude | 100 | MIT |
| civitai/civitai | 100 | Apache-2.0 |
| rubycatco/herdr-fleet | 100 | MIT |
| CMMD-Center/cmmdstack | 100 | MIT |
| ronedgecomb/anything | 100 | Apache-2.0 |
| lvlup-sw/exarchos | 100 | Apache-2.0 |
| NISH1001/vibepiler | 100 | MIT |
| Mooshieblob1/MooshieUI | 100 | AGPL-3.0 |
| Everyone-Needs-A-Copilot/claude-copilot | 100 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki 145827a2a380 (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
- 100cleanup-git
Usuwa scalone lokalne gałęzie git i nieaktualne worktrees, porządkując lokalny stan repozytorium. - 100cleaning-up-branches
Usuwa scalone gałęzie git lokalne i zdalne oraz oznacza stare niescalone gałęzie do ręcznego przeglądu. - 95triage-repo-cleanup
Porządkuje pozostałości w repozytorium: stare worktree, scalone gałęzie, referencje zdalne i stashe, klasyfikując je pod kątem utraty pracy. - 100disk-cleanup
Zwalnia miejsce po agentach i worktrees: cache, scalone worktrees, cache Dockera i stare logi, najpierw w trybie suchego przebiegu. - 100branch-cleanup
Czyści nieaktualne gałęzie git po serii scaleń: usuwa zamknięte i scalone gałęzie zdalne, lokalne gałęzie śledzące oraz lokalne gałęzie już scalone do main. - 100branch-cleanup
Czyści nieaktualne gałęzie git po serii scaleń: usuwa zamknięte i scalone gałęzie zdalne, lokalne gałęzie śledzące oraz lokalne gałęzie już scalone do main.