AgentDust
Process ownership and approved cleanup for Claude Code.
My Mac was running hot, so I checked what my AI coding sessions had left behind. I found six old processes, all idle at 0% CPU. They did not explain the heat, but some still held ports. I wanted to see which session a helper belonged to before deciding whether to stop it.
AgentDust connects helpers to Claude Code sessions through an inherited marker and a local journal. Its read-only doctor explains the ownership evidence. Cleanup asks for my typed approval, then takes a fresh inventory, reclassifies the process and checks its identity before sending SIGTERM.
Built in Rust for Apple silicon macOS, with a CLI and an MCP server. The cleanup design documents the remaining PID reuse race and the choice to avoid process groups and escalation to SIGKILL.Read why I built it and how it works
- 2.5 ms hook p50 on macos-15
- 27.2M fuzz inputs in one 61 s run
- 1,973 tests passed in linked macOS CI run
Rust, MITCodeInstall with Homebrew