Self-hostedOpen sourceApache 2.0

GitHub orchestration for coding agents.

Run Claude Code and Codex on your own server. Execute tasks in isolated workspaces, and refine the results through standard GitHub pull requests.

Installs in two commands via npm

2,100+ merged PRs Over a year of daily use Inspect the track record
ProPR works with:
GitHub
Claude Code Codex Antigravity CLI Mistral Vibe OpenCode

GitHub is the control plane.

Assign ProPR to your GitHub issues and get a pull request back. Agent will work on it independently. After the PR is open, you can keep working on it by sending followup requests directly via GitHub comments.

  1. 01Define the issue in GitHubStandard repository issue.
  2. 02Apply the AI labelTriggers the agent run.
  3. 03Agent executes in isolationSecure Docker workspace.
  4. 04ProPR opens a pull requestIncludes diff, logs, and token cost.
  5. 05Leave normal review commentsTo request fixes or changes.
  6. 06Agent pushes follow-up commitsDirectly to the PR branch.
  7. 07Make the final merge decisionHuman approval remains required.

Bring ProPR control into chat.

MCP connects chat to the full workflow: discover repositories and models, plan issues, steer goals and tasks, inspect diffs, review and fix PRs, and request a guarded merge.

Explore MCP from chat →

Direct to your instance. Or through Connect.

Both routes use the same core controls. Browser OAuth defines access; agents and execution remain on your infrastructure. ProPR exchanges text and structured data. Your chat host handles any speech features.

Check MCP availability and operator setup. Compare access and privacy for each route.

Plan the architecture. Review the execution.

Herding agents to process GitHub issues is great. But ProPR is more than that. Larger features need deeper planning, and finished pull requests need a rigorous second opinion by a different agent. ProPR adds dedicated controls for issue planning and code review, then returns every task and finding to the same GitHub workflow.

Planning

Shape the plan before code starts.

ProPR comes with a powerful planning tool, which turns repository context and requirements into review-sized tasks with specifications, acceptance criteria, and suggested implementation. Refine the plan in conversation, then create the GitHub issues.

Explore planning
Planner Studio showing a prepared four-task plan with acceptance criteria and conversational refinement
Review the tasks, acceptance criteria, and implementation guidance before execution.
Pull request review

Run a read-only critique against the work requested.

Comment /review and ProPR reads the source issue, prior branch changes, current diff, PR conversation, and changed files. It posts severity-grouped findings and a numeric score in GitHub without modifying code.

Explore PR review
A real ProPR review on pull request 1613 with severity-grouped findings and a score of seven out of ten
First review on public propr #1613.

Can I still use Claude directly?

Direct agents fit live exploration. ProPR fits planned development that needs a visible task history and GitHub review.

Fast exploration

Use direct agents while you are still thinking through the code.

Claude Code, Codex, and other CLI sessions fit hot-reloading servers, continuous log tailing, and tight interaction with a live environment.

Reviewable delivery

Use ProPR when the change needs a plan, isolated execution, and a clean pull request.

ProPR runs delegated work in a separate branch, Git worktree, and Docker workspace, then keeps the prompt, diff, logs, cost, follow-ups, and review in GitHub.

Direct and delegated work share one process: debug directly, commit useful progress, then bring the branch into ProPR for planning, follow-up, review, and merge.

We build everything with ProPR.

Since May 2025, every product we ship has moved through ProPR's own plan, run, and review loop — including ProPR itself.

2,400+pull requests opened by ProPR
2,100+of them merged
690+merged PRs building ProPR itself
14+ Monthsof daily dogfooding

Run ProPR where your engineering system already lives.

ProPR is free, 100% open-source, and self-hosted. Your repositories, task history, logs, and credentials stay under your control. It connects to GitHub, keeps agent execution isolated, and makes the trust and security model explicit. Use your existing AI provider subscriptions or bring your own API keys for metered billing — either way, ProPR never marks up your tokens.

Use Linux or Mac with Docker tor run ProPR.

npm install -g propr-cli
propr setup
GitHub Issues, PR comments, reviews, and merges — where the team already works.
Your ProPR stack A Docker stack on your server: plans tasks, runs agents in isolated worktrees, opens and refines PRs.
Your agents Claude Code, Codex, and the rest — on your subscriptions or API keys.

Common questions.

ProPR is for planned, PR-centered engineering changes. For the deeper operational and security questions, see how ProPR works.

What is ProPR, in plain terms?

ProPR is the PR-centered process around coding agents. You start with a plan, run the task in an isolated workspace, get a pull request, and keep refinements inside GitHub. Claude Code, Codex, and other coding agents remain the implementation layer. ProPR gives them a shared engineering process.

Why keep the loop in GitHub?

Because that is where teams already review code. The diff, comments, checks, approvals, and merge decision stay in the place engineers trust. Agent output stops living in terminal scrollback or chat history and starts living in the same pull request loop as human-written code.

How is this different from running the agent in my terminal?

A terminal session asks you to approve commands and edits as it goes. ProPR delegates that control to the isolated workspace and moves your approval to the pull request. Scope the task well and it works like delegating to another engineer — label the issue, walk away, review the PR. Follow-up is lighter too: screenshots paste straight into GitHub comments, ready for the next follow-up.

Does ProPR work with GitLab or Bitbucket?

ProPR supports GitHub. The loop uses GitHub's pull requests, review comments, status checks, and comment controls to drive follow-up work. GitLab and Bitbucket fall outside the current product boundary.

Is it safe to let agents run on their own?

Each task runs away from the main checkout in its own Git worktree, branch, and Docker workspace. ProPR performs branch, commit, and push operations deterministically. An optional allowlist firewall restricts outbound access to required endpoints; it is off by default and needs elevated container privileges. Every result returns through commits and a pull request that people can review, retry, discard, merge, or revert. Revert the commit or close the PR — the record of the attempt feeds the next one.

What happens when CI fails on an agent's PR?

ProPR watches whether checks pass — an Ultrafix loop waits for green before it continues — but it works from the pull request conversation and never reads your CI logs. When a build or test fails, paste the failing output into a PR comment and ask for a fix. ProPR routes that into another isolated run and lands the correction as a follow-up commit on the same branch.

Do we have to use one provider or pay for new billing?

No. ProPR runs on provider subscriptions you may already pay for, including Claude Pro and ChatGPT Plus. Direct API keys work too, with metered billing. Use one provider or several, and route each phase to the agent that earns it. Either way, ProPR never marks up tokens.

Can ProPR work straight from GitHub issues?

Yes. Add a trigger label (such as AI or propr) to an issue and ProPR picks it up, implements the change in an isolated run, and opens a pull request linked back to the issue. Model labels like llm-claude-sonnet46 choose the agent, a base-<branch> label targets a non-default branch, and state labels track progress automatically. Several model labels on one issue produce separate branches and PRs to compare.

What about changes too big for one PR?

Planning splits a broad prompt into review-sized tasks, and Epic mode runs them as an ordered chain: each task becomes its own PR, and the next one starts only after the previous PR merges — optionally auto-merging on green CI. A large change ships as a sequence of reviewable diffs. Each branch stays focused.

Can we switch agents during the same change?

Yes. The branch, commits, task page, and pull request give every agent the same visible starting point. A PR can start with one agent, get reviewed by another, and receive a follow-up from a third while the complete sequence remains in GitHub.

How does ProPR know what code to include?

The planning flow builds a context preview before implementation starts. ProPR combines the files you name, files it believes are relevant, repository summaries, screenshots, attachments, and optional reference repositories. ProPR shows the model the code it needs without dumping the whole repository.

What can we monitor afterwards?

Plans, prompts, task history, commits, file changes, logs, model choices, cost, and follow-up activity stay attached to the task. Branches, commits, and PR conversations also remain in GitHub, where your existing tools can clone, grep, and diff them.

Can we run it from a phone?

Yes. Agents run on your server, so a device only steers. The web UI is mobile-optimized for plans, tasks, logs, and dashboards, and because iteration happens in GitHub comments, the GitHub mobile app works as a remote control: label an issue, review the diff, leave a plain comment like Please handle 429 retries for temporary provider rate limits., and the follow-up commit lands on the same PR. See mobile and remote control.

Can teams automate it?

Yes. The web UI is the primary interface. The CLI covers plans, tasks, repositories, agents, settings, todos, logs, active tasks, and system status, so scripts and CI jobs still use the normal review path.

What do we need to self-host?

You need a Docker-capable Linux host, GitHub access for the repositories you want to work on, and provider access for the agents you want to use. Plans, tasks, and task logs stay in your ProPR stack. The LLM calls go to the providers you configure. The quickstart takes you from install to the first agent PR.

Everything you need to run it is public and free to self-host.

The source, images, documentation, and live demo are available immediately. Install with two commands and review your first agent PR.

  • Apache 2.0 across the stackThe engine, web UI, CLI, and agent runtimes live in one public repository. Read it before you run it.
  • Prebuilt imagesThe launcher starts the whole stack from published images, and upgrading is an image pull.
  • Explicit data routesProPR execution stays self-hosted. Connect clears webhook payloads after successful delivery and retains delivery statistics separately. The optional MCP gateway also processes chat tool arguments and results, including code context. Inspect the data boundary.

How does ProPR compare?

See how ProPR fits into your existing stack. We break down the exact architectural differences, when to use live IDE agents, and when to delegate to ProPR’s PR-native pipeline.