howells

prune-agents

Kill orphaned Claude subagent processes that didn't exit cleanly. Use when asked to "prune agents", "clean up agents", "kill orphaned processes", or when subagents accumulate from Task tool usage.

howells 22 2 Updated 3mo ago
GitHub

Install

npx skillscat add howells/arc/prune-agents

Install via the SkillsCat registry.

SKILL.md

Prune Orphaned Agents

Run the cleanup script to kill orphaned Claude agent processes.

${CLAUDE_PLUGIN_ROOT}/scripts/cleanup-orphaned-agents.sh

This kills Claude Code processes that have become detached from their terminal (TTY shows "??"). These accumulate when the Task tool spawns subagents that don't cleanly exit after completion.

Safe to run anytime — only kills orphaned processes. Active terminal sessions are preserved.

After running, report the result to the user including how many processes were cleaned up.