Profile My skills Saved Collections Edit profile Submit a skill

Agent Broom

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".

kevin-liu-01 Updated
AI & ML

File contents

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.

kevin-liu-01/agent-broom/tree/main/skill commit 0f571fd827

Browse category

Frequently asked questions

npx skillmds@latest add kevin-liu-01/agent-broom