Brad HeitmannBH
Agent skill Published

Repository cleanup for coding agents

Mister
Clean.

Point it at a messy repository. It finishes work that was left half-done and updates the plans to match the code. After that, it checks every new commit so the repository stays clean.

An agent should be able to start work right away.

Agents copy what they find. A repository full of stale plans and abandoned branches slows down the next agent, which reads them and repeats the mistakes in them.

Why use itAgents start from a clean repository.
Install pnpm add --global @bradheitmann/mister-clean@7.5.1
Use it $mister-clean

Register the package's SKILL.md with your agent (pnpm root -g shows the install folder), then type /mister-clean in Claude Code or $mister-clean in Codex.

Or connect it as an MCP server (POST only) https://mister-clean.bradheitmann.ai/mcp

Current release.

MIT licensed. The release notes and full documentation are in the repository.

Published · v7.5.1 · 2026-11-05 · judged CLEAN by its own installed release

The state of a repository, on one page.

The dashboard below is the report Mister Clean publishes for a repository: its current state and what the last cleanup changed. A repository is marked clean only when all checks have passed.

Open the dashboard →
Close mode

Cleans up a repository you have inherited.

Before a handoff it finishes outstanding work and runs the checks. If something stops it from finishing, it tells you what.

Guard mode

Checks every commit.

Commits are checked before they land. Anything that would leave the repository less clean is fixed first.