Przejdź do treści
Biblioteka skilli
Programowanie · Automatyzacja

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.

Licencja
MIT
Ostatnia zmiana repozytorium
25.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 25.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • 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. 1. Scope
  2. 2. Scan
  3. 3. One confirmation
  4. 4. Apply
  5. 5. Report
Sekcje z nagłówków SKILL.md, w oryginale · 71 linii, 624 słów
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

RepozytoriumWynikLicencja
Ta strona · davepoon/buildwithclaude100MIT
civitai/civitai100Apache-2.0
rubycatco/herdr-fleet100MIT
CMMD-Center/cmmdstack100MIT
ronedgecomb/anything100Apache-2.0
lvlup-sw/exarchos100Apache-2.0
NISH1001/vibepiler100MIT
Mooshieblob1/MooshieUI100AGPL-3.0
Everyone-Needs-A-Copilot/claude-copilot100MIT

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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.