| name | agent-broom |
| description | Remember to run Agent Broom, the script-backed process tracking, audit, and cleanup tool. Use before starting another localhost server, before ending a turn that spawned long-running processes, when CPU/memory is high, when disk is low, or when the user says "what is running", "devclean", "orphaned MCP", "cleanup terminals", "localhosts out of control", or "free disk space". |
Agent Broom
This skill is the memory hook. It exists so agents remember to run the CLI.
The deterministic cleanup behavior lives in bin/agent-broom, bin/ports,
bin/whoisonport, and lib/*.sh.
Start with the port checker surface when the user asks what is running or when a
localhost port may be occupied:
bin/agent-broom ports --json
bin/agent-broom port <PORT> --json
bin/agent-broom ps --json
Run a dry-run audit first:
bin/agent-broom audit
Record long-running commands you start:
bin/agent-broom add --pid <PID> --kind dev --port <PORT> --purpose "<why>" -- <command>
Before ending the turn:
bin/agent-broom audit
Only act after reviewing the dry run:
bin/agent-broom kill <PORT|PID|RANGE>
bin/agent-broom kill --apply <PORT|PID|RANGE>
bin/agent-broom clean
bin/agent-broom clean --apply
bin/agent-broom stop --kill
bin/agent-broom artifacts --clean
bin/agent-broom devclean --apply
Never kill the editor, Codex, the user's shell, or shared MCP servers unless the
script proves they are safe orphaned targets.
