plonge — скилл для Claude Code: очистка кэшей, установка
Скилл plonge для Claude Code ищет кэши, зависимости и результаты сборки. Запускается, когда заканчивается место или сборка сообщает no space left on device.
MIT ★ 260 обновлён 2026-11-17
npx skills add mattt/plonge --skill plonge -a claude-codeЧто делает plonge
Скилл plonge проверяет свободное место, находит кэши проектов и глобальные кэши, а затем готовит очистку. Сначала он запускает plonge disk и сканирование, показывает самые крупные каталоги и отделяет правила prune от clear. Команды clean без --apply ничего не удаляют.
Очистка проектов и глобальных данных выполняется отдельно через plonge clean и plonge clean --global; перед --apply скилл запрашивает подтверждение выбранных путей и оценивает освобождаемое место. Активные и занятые проекты исключаются по правилам активности и проверке процессов. Если paseo нет в PATH, проверка занятых агентов не защищает проект от очистки; если статус paseo не читается, все проекты считаются занятыми.
Какие задачи решает
- найти кэши, занявшие место на диске
- разобраться с ошибкой
no space left on device - проверить кэши проектов и глобальные кэши
- провести сухой запуск очистки без удаления
- удалить старые зависимости и результаты сборки после подтверждения
Примеры запросов агенту
- Проверь свободное место и найди самые крупные кэши.
- Сделай сухой запуск очистки кэшей проектов и покажи выбранные пути.
- Очисти глобальные кэши после подтверждения, сохранив выбранные параметры.
Как установить plonge
1Через Skills CLI (Vercel)
npx skills add mattt/plonge --skill plonge -a claude-code2Вручную: положить файлы
~/.claude/skills/plonge/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/plonge/
1Через Skills CLI (Vercel)
npx skills add mattt/plonge --skill plonge -a codex2Вручную: положить файлы
.agents/skills/plonge/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add mattt/plonge --skill plonge -a cursor2Вручную: положить файлы
.cursor/skills/plonge/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install mattt/plonge skills/plonge2Вручную: положить файлы
.github/skills/plonge/SKILL.md1Через Skills CLI (Vercel)
npx skills add mattt/plonge --skill plonge -a gemini-cli2Командой платформы
gemini skills install https://github.com/mattt/plonge --path skills/plongeВручную: положить файлы
.devin/skills/plonge/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о plonge
Как установить plonge в Claude Code?
Выполните npx skills add mattt/plonge --skill plonge -a claude-code, затем файл скилла будет доступен по пути ~/.claude/skills/plonge/SKILL.md.
Что делает plonge?
plonge проверяет свободное место, находит кэши проектов и глобальные кэши, показывает их размеры и готовит очистку. Удаление начинается только с --apply после подтверждения сухого запуска.
Что нужно для работы plonge?
Для проверки занятых Paseo-агентов нужен paseo в PATH. Если статус paseo нельзя прочитать, проекты считаются занятыми и очистка проектных кэшей не выполняется.
Исходный текст
SKILL.md · MIT
--- name: plonge description: Find and clean developer caches, downloaded dependencies, and build output. Use when disk space is low, a build fails with "no space left on device", or the user asks to clean caches, node_modules, virtual environments, or tool downloads. --- # Plonge Plonge reports project caches and global caches outside projects. A cache is a directory or set of files selected by a cleanup rule. Project roots come from mise's record of loaded config files, or from CLI `--root` options. `scan` and `clean` without `--apply` delete nothing. If the Plonge MCP server is available, use its `scan`, `clean`, and `disk` tools. MCP parameters have the same meaning as the corresponding CLI options, but MCP does not support `--root` or `--no-mise`. ## Steps 1. Check free space with `plonge disk`. It reports space on the home directory's volume on macOS and Linux. 2. Scan before cleanup. Include global caches for a report of both project and global caches. ```console plonge scan --global ``` 3. Show the largest caches, their sizes, and the totals. A quiet project has known activity at least `quiet_hours` old (24 hours by default). An active project has more recent or unknown activity. A busy project has a running or initializing Paseo agent. Plonge refuses a project cache that a running process uses and names the process in the report. Project cleanup excludes busy projects and, by default, active projects. Say which global rules are `prune` and which are `clear`. A `prune` rule uses the tool's policy to select unused or stale data. A `clear` rule can remove cached data still in use; later commands may need to download dependencies or rebuild files. Global cleanup does not use the project activity or Git checks. 4. Run a dry run and show the output. Project and global cleanup are separate operations: ```console plonge clean plonge clean --global ``` 5. Get the user's approval of the dry run before `--apply`. State the selected paths or actions and the estimated space to recover. Do not promise that the whole reported size will become free space. A size marked `(whole cache)` is a prune rule's whole cache; say that the tool removes only part of it. Keep the approved selection options when you apply the cleanup. ```console plonge clean --apply plonge clean --global --apply ``` 6. Report the estimated space freed, the change in free space on the home directory's volume that the same output gives, and any skipped or failed cleanup. Other processes can also change free space, so do not call the change exact. ## Selection options Get approval for these options as part of the dry run: - `--include-active` selects active projects, but still excludes busy projects. - `--include-clear` with `--global` selects clear rules. - `--min-size 100MiB` skips project caches smaller than 100 MiB. `--global` cannot be combined with `--include-active`, `--min-size`, `--root`, or `--no-mise`. Project activity is based on Git HEAD timestamps, Claude transcripts, and Paseo status, not on uncommitted edits or running builds. If `paseo` is not on PATH, the busy check cannot see Paseo agents and gives no protection. If `paseo` is on PATH but its status cannot be read, every project counts as busy, so `clean` deletes no project caches until Paseo works again. The running-process check sees only processes that run when Plonge checks; it does not see a stopped service or a later cron job. If Plonge cannot list the processes, every project counts as busy. Do not clean caches in a project that you know is busy. Do not use another deletion command to bypass a skipped path or rule. Check the reported reason and explain it to the user.
© mattt · MIT · mattt/plonge