cleanup

name	cleanup
description	Kill orphaned Claude Code processes, remove old versions, and report memory/disk usage. Use when the system feels slow or after crashes.
user_invocable	true

Claude Code Cleanup

Kill orphaned Claude Code processes (bun workers, subagents, MCP servers) and remove old binary versions.

Steps

1. Survey orphaned processes before cleanup:

   echo "=== Orphaned bun workers (PPID=1) ===" && \
   ps -eo pid,ppid,tty,rss,command | grep 'worker-service\.cjs.*--daemon' | grep -v grep | awk '$2 == 1' && \
   echo "=== Detached claude subagents ===" && \
   ps -eo pid,ppid,tty,rss,command | grep 'claude.*--output-format.*stream-json' | grep -v grep | awk '$3 == "??"' && \
   echo "=== Detached MCP servers ===" && \
   ps -eo pid,ppid,tty,rss,command | grep 'node.*mcp-server' | grep -v grep | awk '$3 == "??"' && \
   echo "=== Memory summary ===" && \
   ps -eo rss,command | grep -E '(worker-service|claude.*stream-json|node.*mcp-server)' | grep -v grep | awk '{sum += $1} END {printf "Total RSS: %.0f MB\n", sum/1024}' && \
   echo "=== Old Claude versions ===" && \
   CURRENT=$(claude --version 2>/dev/null | awk '{print $1}') && \
   for f in ~/.local/share/claude/versions/*; do \
     v=$(basename "$f"); size=$(du -sh "$f" | awk '{print $1}'); \
     if [ "$v" = "$CURRENT" ]; then echo "  $v ($size) [CURRENT]"; else echo "  $v ($size) [OLD - will remove]"; fi; \
   done
   

2. Show the user what was found and how much memory it's using.

3. Ask the user for confirmation before killing anything.

4. Run cleanup:

   ~/.claude/hooks/cleanup-processes.sh
   

5. Report results:

   echo "=== Cleanup log ===" && tail -5 ~/.claude/logs/cleanup.log
   

6. Show current memory after cleanup:

   ps -eo rss,command | grep -E '(worker-service|claude.*stream-json|node.*mcp-server)' | grep -v grep | awk '{sum += $1} END {printf "Remaining RSS: %.0f MB\n", sum/1024}'