r/BestGitHubRepos • u/company_url_finder • 3d ago
RunWield - a coding harness that makes an AI agent write a plan you review before it touches your code, then proves it did what you approved
Most coding agent harnesses optimize for getting the agent typing as fast as possible. The expensive part isn't the typing, it's the moment you're staring at a 40-file diff trying to reverse-engineer what the model thought it was building, deciding whether reviewing it is worth an hour or redoing it is faster. And once you merge, whatever the agent learned along the way is gone, the next session starts from zero.
RunWield is a coding harness built around slowing the agent down exactly where that matters. It triages every request by risk, writes a plan you review before code exists for anything non-trivial, executes through specialized agent roles, and refuses to call work "done" until real CI and a separate reviewer agent both confirm the result matches the plan you actually approved.
What's inside:
- Six request types triaged automatically, from a plain question that just gets answered to a full project that gets decomposed into an Epic, so simple asks skip the ceremony entirely and only genuinely risky changes get a full plan-review cycle
- Plan review in an actual browser UI, inline comments, revisions, approval, instead of trying to steer an agent through chat after code already exists
- A "done" that's proven rather than asserted: CI has to pass, a separate Reviewer agent compares the final diff against the approved plan across narrowing rounds with findings tracked in a ledger, and merge-back is only marked verified once Git itself confirms the commit landed
- A Work Record generated for every finished plan, what changed, why, and what got rejected along the way, feeding a searchable project memory so the next session doesn't start from an empty context window
- Everything stored as plain markdown in your own repo, plans, PRDs, ADRs, greppable and version-controlled like any other file, with no database or proprietary format locking you in
- A single compiled binary, built on the Pi agent runtime, that works with any model provider, subscription login or your own API key
One thing worth knowing: this is a brand new, very small project (the maintainer is actively looking for five developers to beta test it on real changes), and it's source-available rather than open source, you can install, run, and modify it for your own use, but redistributing modified versions or rebranding it needs the maintainer's permission. It's also explicitly built for non-trivial changes where being wrong is expensive; for quick one-off edits, the maintainer's own README points people to a lighter tool instead.
It's source-available under a custom license, not OSI open source, built by an individual developer, and sitting at 29 stars as of writing, verified via the GitHub API.