pr-reviewer/docs/setup.md

Setup

1) Create the repository and bot user

1. Create Bram/gitea-pr-review-bot.
2. Create the dedicated Gitea user comedykit-pr-bot.
3. Create a PAT for that user with scopes:
   • write:repository
   • write:issue

2) Configure secrets

Create .env from .env.example and set:

• CURSOR_API_KEY
• GITEA_TOKEN
• GITEA_BASE_URL
• GITEA_BOT_LOGIN
• WEBHOOK_SECRET
• PORT

3) Install and run locally

npm install
npm run dev

Health check:

curl http://localhost:8787/healthz

4) Configure Gitea webhook

Add an organization webhook for Bram (or per repo for pilot) with:

• URL: https://<bot-host>/webhooks/gitea
• Secret: matches WEBHOOK_SECRET
• Events:
  • pull_request
  • pull_request_review_request

5) Pilot rollout

Start with:

• comedykit-frontend-new
• comedykit-backend-new

After validation, enable org webhook for remaining Bram/* repositories and use .gitea/pr-review-bot.yml for per-repo opt-out.