Skip to content
PR Bot
Menu

Get started

Get started

PR Bot is self-hosted. The quickest path is Docker Compose, which starts Temporal, the API, the worker and the web app.

Read the docs (private repo)Ask for access
  1. Step 1

    Get the code

    Clone the pr-bot repository. It is private to the catesworks organization today, so ask for access through the contact form.

  2. Step 2

    Configure

    Copy .env.example to .env and fill in Auth0, a GitHub token and/or an Azure DevOps PAT, and the URL of each MCP provider on your MCP bridge.

  3. Step 3

    Start it

    Run docker compose up, then open the web app on port 3000 and sign in.

  4. Step 4

    Watch a repo

    Add a watched repo in Settings, then open a pull request in it. PR Bot reviews it.

What you need

  • Docker, or Node 24 and pnpm 11 to run the services directly
  • An Auth0 application for sign-in (the desktop app can run without sign-in)
  • A GitHub token or an Azure DevOps PAT for the repos you want reviewed
  • A running mcp-agent-bridge service for the AI work

Prefer a desktop app?

The desktop app runs PR Bot on one Mac with an embedded Temporal server and a local SQLite database. The release workflow builds it as a .app bundle for Apple silicon Macs; there is no public download yet, and a Windows build is not available.