claude-cpu-guard
Claude Code uses React/Ink for its terminal UI. Sometimes the render loop gets stuck and burns CPU even when idle. This plugin detects it and kills the stuck process automatically.
!demo
After killing, it prints the resume command. Press ↑ Enter to restart your session.
Why?
Claude Code's TUI runs a React scene graph at 60fps — layout, rasterize, diff, generate ANSI — all for a terminal that only changes when you type or receive output. When this render loop gets stuck, your CPU melts while Claude sits idle.
- Reddit: "Does anyone face high CPU usage when using Claude?"
- ThePrimeagen: "Claude Code's TUI is Ridiculous"
Install
In Claude Code, run:
/plugin marketplace add yemreak/claude-cpu-guard
/plugin install claude-cpu-guard@claude-cpu-guardOr clone manually:
git clone https://github.com/yemreak/claude-cpu-guard ~/.claude/plugins/claude-cpu-guardThat's it. No config needed. macOS only for now — Linux and Windows contributions welcome.
How it works
Three hooks, one script, zero config:
| Event | Action | |---|---| | SessionStart | Caches session ID | | UserPromptSubmit | Marks state as "working" (won't kill) | | Stop | Marks state as "stopped" → starts 30s CPU watch |
Kill only happens when all 6 checks (every 5s for 30s) show CPU > 70% while state is "stopped". If you type anything during that window, the kill is cancelled.
Uninstall
/plugin uninstall claude-cpu-guard@claude-cpu-guardOr remove manually:
rm -rf ~/.claude/plugins/claude-cpu-guardLicense
MIT
