claude-cpu-guard

skill
Security Audit
Warn
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 7 GitHub stars
Code Pass
  • Code scan — Scanned 4 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Claude Code burns your CPU while idle? This plugin watches and kills stuck processes automatically.

README.md

claude-cpu-guard

optionOS — Show AI what you mean. Stay in your flow.

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.

Install

In Claude Code, run:

/plugin marketplace add yemreak/claude-cpu-guard
/plugin install claude-cpu-guard@claude-cpu-guard

Or clone manually:

git clone https://github.com/yemreak/claude-cpu-guard ~/.claude/plugins/claude-cpu-guard

That'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-guard

Or remove manually:

rm -rf ~/.claude/plugins/claude-cpu-guard

License

MIT

Reviews (0)

No results found