What problem does it solve? Shutting down peer Claude Code sessions is error-prone because the hive-mcp list_peers tool returns the wrong PID (the bun hive-mcp child process, not the actual claude binary). Killing that PID leaves the session alive and spawning a new hive-mcp child. This Skill provides a reliable procedure to find the real claude binary PID by working directory, kill it safely, and clean up orphaned processes. ## Core Features & Use Cases - Correct PID Resolution: Maps claude binary PIDs to their working directories using ps and lsof, avoiding the misleading PIDs returned by list_peers. - Safe Termination Workflow: Excludes the team-lead's own session, uses explicit PID kills (which pass the permission classifier, unlike pkill patterns), verifies termination, and escalates to kill -9 if needed. - Orphan Cleanup & Graceful Shutdown: Sweeps orphaned hive-mcp server processes reparented to launchd, and supports messaging peers to checkpoint in-flight work before killing them. - Use Case: After a /weekly-plan pass decides which agents are needed, spin down the peers not on this week's committed goals to free memory, then confirm via list_peers that they are gone. ## Quick Start Ask the agent to shut down the peer session for a specific project, for example: "Spin down the peer running on the marketing-site project and verify it's gone."
