К основному содержанию
скилл CX Codex

houseclean — скилл для Claude Code: что делает и как установить

Скилл houseclean для Claude Code проверяет подключённые диски на осиротевшие git worktree, разросшиеся кеши AI-инструментов и пересобираемые артефакты сборки.

MIT ★ 937 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local
Открыть на GitHub

Что делает houseclean

Скилл проходит по фазам: сначала снимает состояние всех дисков через Get-PSDrive, затем находит самые тяжёлые папки на диске C (с тегами вроде AI-tool-data или Package-cache), после этого проверяет worktree командой git worktree list и делит их на SAFE TO REMOVE, REVIEW FIRST, STALE и ACTIVE. Worktree из категорий SAFE TO REMOVE и STALE удаляются автоматически через git worktree remove "{path}" --force, а REVIEW FIRST и ACTIVE трогать без подтверждения пользователя не будет.

Отдельная фаза проверяет кеши .ollama, .gemini, .cursor, .windsurf, .codex, .continue, а также кеш npm и pip, помечая всё крупнее 500 МБ. Для переноса на другой диск скилл даёт конкретные команды: для Ollama — robocopy плюс переменная OLLAMA_MODELS, для Cursor и Codex — junction через mklink /J. Основные PowerShell-команды в протоколе написаны под Windows, для macOS и Linux предлагается заменять их на du -sh и df -h с путями через ~/.

Отдельно сканируются node_modules, .venv, __pycache__ и похожие сборочные папки старше 30 дней — их удаление скилл всегда уточняет у пользователя. Для структурных проблем проекта (не диска) во фронтматтере указано использовать /organize, а не этот скилл.

Какие задачи решает

  • найти, что занимает место на диске C и других дисках
  • удалить осиротевшие git worktree после слияния веток
  • перенести кеш Ollama, Gemini CLI или Cursor на другой диск
  • найти node_modules и .venv, которые можно пересобрать заново
  • получить готовые команды миграции для конкретного инструмента

Примеры запросов агенту

  • Запусти /houseclean и покажи, что можно освободить на диске C
  • Сделай /houseclean --worktrees и удали осиротевшие worktree
  • Подскажи, как перенести Ollama на диск F через /houseclean --migrate ollama

Как установить houseclean

1Через маркетплейс плагинов

/plugin marketplace add SethGammon/Citadel
/plugin install citadel@citadel-local

Команда ставит плагин citadel целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add SethGammon/Citadel --skill houseclean -a claude-code

3Вручную: положить файлы

~/.claude/skills/houseclean/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/houseclean/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о houseclean

Как установить houseclean в Claude Code?

Выполните /plugin marketplace add SethGammon/Citadel, затем /plugin install citadel@citadel-local. Альтернативный способ — npx skills add SethGammon/Citadel --skill houseclean -a claude-code, после чего файл появится в ~/.claude/skills/houseclean/SKILL.md.

Что делает houseclean?

Скилл обследует все диски, ищет брошенные git worktree, тяжёлые кеши AI-инструментов (Ollama, Gemini, Cursor) и пересобираемые артефакты вроде node_modules, после чего предлагает план действий с конкретными командами миграции и удаления.

Какие аргументы можно передать команде /houseclean?

Есть режимы --quick (только обзор дисков и быстрые победы), --worktrees, --ai-tools, --projects и --migrate X, где X — ollama, gemini, npm или cursor, для получения инструкции по переносу конкретного инструмента.

Исходный текст

SKILL.md · MIT
---
name: houseclean
license: MIT
description: >-
  Cross-drive storage audit and cleanup. Surveys all drives, finds orphaned git
  worktrees, large AI tool caches (.ollama, .gemini, .cursor, npm, pip), and
  buildable artifacts (node_modules, .venv). Produces a prioritized action plan
  with specific migration commands. Use when disk space is low or worktrees need
  cleanup; do NOT use for project structure issues (use /organize instead).
user-invocable: true
auto-trigger: false
trigger_keywords:
  - houseclean
  - house clean
  - disk space
  - free space
  - c drive full
  - drive full
  - running out of space
  - clean up disk
  - orphaned worktrees
  - clean worktrees
  - disk audit
  - storage audit
  - move to another drive
  - free up space
last-updated: 2026-04-03
---

# /houseclean — Storage Audit and Cleanup

Use when disk space is low, AI tool caches are bloated, or worktrees need cleanup.
Do NOT use for project structure issues (use `/organize`) or pre-merge worktree review (use `/merge-review`).

## Orientation

**Use when:** cross-drive storage audit -- finds orphaned repos, stale branches, and large directories across all drives.
**Don't use when:** auditing project infrastructure only (use /infra-audit); cleaning a specific directory (use Bash directly).

## Invocation Forms

```
/houseclean              # Full audit — all phases
/houseclean --quick      # Drive survey + quick wins only (no deep scan)
/houseclean --worktrees  # Orphaned worktree audit only
/houseclean --ai-tools   # AI tool cache audit only
/houseclean --projects   # Project artifact scan only (node_modules, .venv, etc.)
/houseclean --migrate X  # Migration instructions for a specific tool (ollama, gemini, npm, cursor)
```

## Protocol

### Phase 1: Drive Survey

**Windows (PowerShell):**
```powershell
Get-PSDrive -PSProvider FileSystem | Select-Object Name, Used, Free, Root | Format-Table -AutoSize
```

Present as a table with Drive, Total, Used, Free, Label columns.

Thresholds: C: free < 5 GB → CRITICAL. C: free < 20 GB → WARNING.
Store which drives have free space — these are migration targets.

### Phase 2: C Drive Hot Spots

**Windows (PowerShell):**
```powershell
Get-ChildItem "C:\Users\$env:USERNAME" -Directory -ErrorAction SilentlyContinue |
  ForEach-Object {
    $s = (Get-ChildItem $_.FullName -Recurse -ErrorAction SilentlyContinue |
          Measure-Object -Property Length -Sum).Sum
    [PSCustomObject]@{ GB = [math]::Round($s/1GB,2); Path = $_.Name }
  } | Sort-Object GB -Descending | Select-Object -First 15 | Format-Table -AutoSize
```

Tag each entry:
- **AI-tool-data** — `.ollama`, `.gemini`, `.cursor`, `.windsurf`, `.codex`, `.continue`
- **IDE-cache** — `.vscode`, `.idea`, `AppData\Local\JetBrains`
- **Package-cache** — `AppData\Local\npm-cache`, `AppData\Local\pip\cache`, `.gradle`, `.m2`
- **Conversation-history** — `.claude\projects`
- **Projects** — `Desktop`, `Documents`, user project directories
- **System** — `AppData\Local\Microsoft`, `AppData\Roaming`

### Phase 3: Orphaned Worktree Audit

```bash
git rev-parse --show-toplevel
git worktree list
```

For each worktree (excluding main):
1. Check if branch is merged: `git branch --merged HEAD | grep "{branch-name}"`
2. Verify worktree directory exists
3. Check uncommitted changes: `git -C "{worktree-path}" status --short`

Classify:
- **SAFE TO REMOVE** — merged into HEAD, no uncommitted changes
- **REVIEW FIRST** — not merged, has changes
- **STALE** — path missing (registered but deleted)
- **ACTIVE** — not merged, no changes (possibly in-flight)

Auto-remove SAFE TO REMOVE and STALE:
```bash
git worktree remove "{path}" --force
git branch -d "{branch-name}"
```

Report what was removed. Ask before touching REVIEW FIRST or ACTIVE.

### Phase 4: AI Tool Cache Audit

Check these paths (Windows). Report any > 500 MB:
```
~/.ollama/models          → Ollama LLM models
~/.gemini/antigravity     → Gemini CLI data/cache
~/.cursor                 → Cursor editor
~/.windsurf               → Windsurf editor
~/.codex                  → Codex CLI
~/.continue               → Continue.dev extension
~/.cache/huggingface      → HuggingFace model cache
AppData/Local/npm-cache   → npm package cache
AppData/Local/pip/cache   → pip package cache
AppData/Local/Temp        → Windows temp files
```

Tag recommended action:
- **SAFE TO CLEAR** — rebuilds automatically (npm, pip, temp)
- **MOVE** — redirectable via env var (ollama models, gemini)
- **REVIEW** — needs user decision (cursor settings, IDE data)

### Phase 5: Project Artifact Scan

Scan C: for rebuildable artifacts: `node_modules`, `.venv`, `__pycache__`, `.pytest_cache`, `dist/`, `build/`. Report path, size, last modified. Flag items not modified in > 30 days. Ask user before deleting any.

### Phase 6: Quick Wins Report

```
=== QUICK WINS (safe to act on now) ===
1. npm-cache              5.7 GB   CLEAR    npm cache clean --force
2. Merged worktrees (17)   50 MB   REMOVED  (already done)

=== MOVE TO ANOTHER DRIVE ===
3. ~/.ollama/models       15.8 GB  MOVE→F:  See migration guide
4. ~/.gemini              10.2 GB  MOVE→F:  See migration guide

=== REVIEW WITH USER ===
5. ~/.claude/projects      3.1 GB  REVIEW   Old conversation history

Total recoverable on C: ~47 GB
```

### Phase 7: Migration Reference

#### Ollama (models → another drive)
```powershell
Get-Process ollama -ErrorAction SilentlyContinue | Stop-Process
robocopy "C:\Users\$env:USERNAME\.ollama" "F:\.ollama" /E /MOVE /LOG:ollama-move.log
[Environment]::SetEnvironmentVariable("OLLAMA_MODELS", "F:\.ollama\models", "User")
```

#### Gemini CLI
Check if `GEMINI_HOME` is supported: `gemini --help | grep -i "home\|data\|dir"`

If supported:
```powershell
robocopy "C:\Users\$env:USERNAME\.gemini" "F:\.gemini" /E /MOVE
[Environment]::SetEnvironmentVariable("GEMINI_HOME", "F:\.gemini", "User")
```

If not supported, create a junction:
```powershell
robocopy "C:\Users\$env:USERNAME\.gemini" "F:\.gemini" /E /MOVE
cmd /c mklink /J "C:\Users\$env:USERNAME\.gemini" "F:\.gemini"
```

#### npm cache
```bash
npm cache clean --force
npm config set cache "F:/npm-cache"
```

#### Cursor/Windsurf/Codex (junction method)
```powershell
robocopy "C:\Users\$env:USERNAME\.cursor" "F:\.cursor" /E /MOVE
cmd /c mklink /J "C:\Users\$env:USERNAME\.cursor" "F:\.cursor"
```

#### git worktrees
Move the main repo to another drive:
```powershell
robocopy "C:\Users\$env:USERNAME\Desktop\ProjectName" "F:\Projects\ProjectName" /E /MOVE
```

After moving, record in `.claude/harness.json` (Citadel's shared config path for all runtimes, including Codex):
```json
{ "storage": { "projects_root": "F:/Projects" } }
```

#### Claude conversation history (`.claude/projects`)
Cannot be relocated. Archive inactive subdirectories to a backup drive, or test symlinking.

---

## Fringe Cases

**macOS/Linux:** Use `du -sh`, `df -h`. Paths shift to `~/`.
**Worktree removed but branch exists:** `git branch -d {branch}` after `git worktree remove`.
**Ollama in use:** Stop before moving model files.
**Junction already exists:** `cmd /c rmdir "C:\...\tool-dir"` (no contents deleted), then recreate.
**No other drives:** Clear caches first (npm, pip, temp), then rebuildable artifacts, then unused Ollama models.

---

## Citadel Infrastructure Integration

After running /houseclean, update `.claude/harness.json` `storage` section with `projects_root`, `ai_tools` paths, and `last_audit` date. Future runs verify migrations are still in place.

---

## Contextual Gates

**Disclosure:** "Auditing all drives. Will present deletion suggestions — nothing deleted without your confirmation."
**Reversibility:** amber — deletes files and directories if user confirms; undo requires git or manual recovery for non-git files
**Trust gates:**
- Any: view audit findings and suggestions
- Familiar (5+ sessions): confirms deletions before executing; novices should review suggestions carefully before confirming

## Quality Gates

- Never delete data without confirming branch is merged into HEAD
- Always verify uncommitted changes before removing a worktree
- Always stop Ollama before moving model files
- Show exact commands — no vague instructions
- Re-run drive survey to confirm C: free space increased
- Update harness.json `storage` section for any migrations completed
- If total freed is 0 GB, surface why and what the user must do manually

---

## Exit Protocol

1. Show total space freed this session
2. Show space still recoverable with user action
3. Show current C: free space
4. Suggest: "/houseclean runs well as a monthly check — use /schedule to add it"

```
---HANDOFF---
- Freed: {X} GB (caches cleared, worktrees removed)
- Pending user action: {Y} GB (AI tools to move, projects to migrate)
- C: free space now: {Z} GB
- harness.json storage section: updated / not updated
- Reversibility: amber — deleted files require git or manual recovery; moved files can be moved back manually
---
```

© SethGammon · MIT · SethGammon/Citadel

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
macos-cleaner daymade Скилл macos-cleaner для Claude Code находит, что занимает место на диске Mac, и помогает безопасно освободить его. Запускается при нехватке места или перед удалением файлов. CX Codex +1 1 900установок branch-finish sentimony Скилл branch-finish проверяет состояние Git и помогает безопасно завершить работу: слить изменения, открыть pull request, сохранить или удалить ветку. CX Codex +1 2 600установок disk-hygiene terrylica Скилл disk-hygiene проводит аудит диска на macOS, вычищает кэши сборщиков и находит забытые большие файлы без риска случайно стереть нужное. CX Codex +1 273установок git-worktree-manager Alireza Rezvani Скилл git-worktree-manager для Claude Code создаёт изолированные Git worktrees для параллельной работы над ветками. Он назначает портам отдельные значения, копирует файлы окружения и помогает безопасно убрать устаревшие worktrees. CX Codex +1 581установок ns-execution-gitlab-issue nextstage-brasil Скилл ns-execution-gitlab-issue автоматизирует закрытие задач GitLab: изолирует работу в Git worktree, переключает статусы, запускает кодинг и создаёт Merge Request. CX Codex +1 165установок vm-disk-cleanup MSApps-Mobile Плагин vm-disk-cleanup очищает дисковое пространство в виртуальных машинах и песочницах Claude при ошибках ENOSPC. ★ 11звёзд репо

Из того же набора55

Весь набор →
review Скилл review проводит код-ревью в пять проходов: проверяет корректность, безопасность, производительность, читаемость и согласованность кода. Подходит для проверки файла, каталога или изменений Git. CX Codex +1 ★ 937звёзд репо schedule Ставит повторяющиеся и разовые задачи по cron: по умолчанию пишет запись в Task Scheduler или Unix cron, а не расходует квоту routine-запусков. CX Codex +1 ★ 937звёзд репо qa Скилл qa запускает браузер через Playwright, проходит пользовательские сценарии веб-приложения и сохраняет отчёт со скриншотами. CX Codex +1 ★ 937звёзд репо scaffold Скилл scaffold для Claude Code изучает структуру и стиль проекта, создаёт новые файлы по похожим примерам и добавляет их в существующие точки регистрации. CX Codex +1 ★ 937звёзд репо pr-watch Скилл pr-watch следит за проверками pull request в терминале, читает логи упавших CI-шагов, правит ошибки и предлагает мерж. CX Codex +1 ★ 937звёзд репо ascii-diagram Скилл ascii-diagram для Claude Code строит текстовые схемы с выровненными блоками и стрелками. Вставляет диаграммы в Markdown, комментарии к коду и обычный текст. CX Codex +1 ★ 937звёзд репо triage Скилл triage для расследования GitHub-ишью и ревью PR. Читает открытые задачи, классифицирует, ищет причину в коде, предлагает исправления с файл:строка, при необходимости правит сам. CX Codex +1 ★ 937звёзд репо watch Скилл watch отслеживает изменения в рабочей папке и комментарии-маркеры в коде, чтобы автоматически вызывать нужные скиллы или сохранять задачи. CX Codex +1 ★ 937звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой