theQuert/cc-reaper
12 stars · Last commit 2026-03-31
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 | | File descriptors | VM processes, settings.json, MCP stdio pipes | ~6,200 FDs/hr leak rate |