theQuert/cc-reaper
15 stars · Last commit 2026-05-14
Three-layer automated cleanup for orphan Claude Code processes (subagents, MCP servers, plugins)
README preview
# cc-reaper Automated cleanup for orphan Claude Code processes (subagents, MCP servers, plugins) that leak memory after sessions end. ## The Problem Claude Code spawns subagent processes and MCP servers for each session. When sessions end (especially abnormally), these processes become orphans (PPID=1) and keep consuming RAM and CPU — often 200-400 MB each, with some (like Cloudflare's MCP server) hitting 550%+ CPU. With multiple sessions over a day, this can accumulate to 7+ GB of wasted memory. This is a [widely reported issue](https://github.com/anthropics/claude-code/issues/20369) affecting macOS and Linux users. ### What leaks | Process Type | Pattern | Typical Size | |---|---|---| | Subagents | `claude --output-format stream-json` | 180-300 MB each | | MCP servers (short-lived) | `npx mcp-server-cloudflare`, `npm exec mcp-*`, etc. | 40-110 MB each | | claude-mem worker | `worker-service.cjs --daemon` (bun) | 100 MB | | Agent browser sessions | `agent-browser-darwin-arm64`, Chrome-for-Testing with `agent-browser-chrome-*` profiles | 100-600 MB each | | Puppeteer headless Chrome | Chrome/Chrome Helper with `puppeteer_dev_chrome_profile-*` profiles | Can pin CPU/GPU | | Codex background sessions | `node /usr/local/bin/codex`, `@openai/codex/.../codex --yolo` | Session + MCP tree |