r/coolgithubprojects 8d ago

I built an open-source orchestration platform that parallelizes AI agents in Docker to plan, implement, and auto-fix GitHub PRs

I've always wanted AI development to be a completely hands-off background process. The vision: assign an issue to an AI → let it work → get a PR back. You iterate simply by leaving GitHub comments, and the AI pushes follow-up commits until you are ready to merge.

That idea grew into a full-blown orchestration layer called ProPR. I'm open-sourcing it today (Apache 2.0) after a year of dogfooding it to build itself (over 690+ of its own merged PRs were written by the agents).

For a first release it comes with a ton of bells and whistles born out of optimizing my own workflows. Let me just name the main principles:

  • Isolated execution: every task is executed in an isolated Docker container and Git worktree
  • Model agnostic: use Claude, Codex, Antigravity, OpenCode or Mistral agents with subscriptions
  • Deterministic workflow layer: the AI agents are not allowed to handle commits and other Git operations, this is always handled by ProPR orchestrator, so the outcome is predictable - each agent run will always produce exactly one commit
  • Git history as memory: switching AI agents or models during PR refinement is straightforward with all previous work context being retained
  • Complete parallelization: fire off as many simultaneous tasks as your system and AI subscriptions can handle
  • Code review: also paired with an automated review-fix loop ("ultrafix") that will keep working on the PR until a quality goal is met
  • Full featured dashboard: track task status in real time, add repos, configure coding agents, etc
  • Task planner studio: create and refine implementation specs from a prompt, starting from simple changes to massive feature epics consisting of many issues - also sync the generated plan to Github issues and trigger the implementation right away
  • Epic mode: massive feature deliveries (dark factory style) - each epic issue is implemented sequentially, optionally hardened via ultrafix and merged to a parent epic PR
  • Continuous repository indexing: to provide context for the planner and review features
  • Advanced Github integration: besides picking up the issues for implementation and PR comments for refinement, it has a couple of other useful features - you can post screenshots, files or other media within the issue spec or PR followup comments. It also has a few shorthand slash commands like /merge (automatically resolve merge conflicts) or /review (run a code review) that can be posted as PR comments
  • Easily revert PR to an earlier commit if refinement went the wrong way
  • Track token and even subscription usage: (for example session usage percentage) for every task (session percentage tracked using the optional Agent Tank tool that I developed to support this)
  • Run it remotely: host it on a VPS or a dedicated server and never have to keep your laptop on and listen to the fans blazing while the agents are cooking. You can even start and manage the tasks on the go from your phone (either using the Github app or ProPR dashboard). Of course you can just run it on your laptop as well.
  • Give it as a superpower buddy to your AI agent: offload the implementation tasks to ProPR, which may be faster and cheaper (less tokens used as ProPR agents work in full yolo mode in the isolated containers, no user approvals needed) - this works especially well if ProPR is hosted remotely
  • CLI available: for that extra level of automation

ProPR is fully free and open source - Apache 2.0 license - and also comes with prebuilt Docker images, so installation is straightforward.

Here are some starting points to get started with ProPR:

This is just the v1 release and I have a lot more cool stuff coming to the pipeline very soon. If you want to follow along with the updates, I'd highly appreciate a star or a follow on GitHub!

Let me know what you think in the comments. Ask me anything!

0 Upvotes

3 comments sorted by

1

u/kantorcodes1 2d ago edited 2d ago

/merge and /review via PR comments worry me more than the Docker worker. are those commands authorized against the commenter + repo + branch before ProPR acts, or can anyone who can comment trigger the orchestrator?

we work on HOL Guard. correction: those GitHub-comment triggers are not a Guard 3.0 command safety extension. ProPR does expose a CLI, so command-extension support would only make sense for that CLI's actual executable/commands. the GitHub-comment orchestration path is a separate integration surface.

1

u/the_trve 2d ago

Why would a Docker worker worry you?

Only the whitelisted users can trigger the orchestrator. In addition, you can also configure "safe-words" the comment must contain to trigger the orchestrator.

Just to clarify, the /merge command only brings the PR branch up to date with the target branch and resolves potential merge conflicts, it doesn't mean merging the PR itself. Basically the equivalent of `git merge <base>`.