review-bot

Automated code review bot for Gitea. Fetches a pull request diff, sends it to an LLM for analysis, and posts a structured review back to the PR.

Features

• Fetches PR metadata, diff, and CI status from Gitea API
• Sends context-rich prompts to any OpenAI-compatible LLM
• Parses structured JSON review responses
• Posts formatted reviews (APPROVE / REQUEST_CHANGES) back to Gitea
• Supports custom coding conventions via repo files
• Zero external dependencies — Go stdlib only

Usage

review-bot \
  --gitea-url https://gitea.example.com \
  --repo owner/name \
  --pr 42 \
  --reviewer-token "$GITEA_TOKEN" \
  --llm-base-url https://api.openai.com/v1 \
  --llm-api-key "$OPENAI_API_KEY" \
  --llm-model gpt-4 \
  --reviewer-name "Sonnet" \
  --conventions-file CONVENTIONS.md \
  --dry-run

Environment Variables

All flags can be set via environment variables:

Flag	Env Var	Required	Description
--gitea-url	GITEA_URL	Yes	Gitea instance base URL
--repo	GITEA_REPO	Yes	Repository in owner/name format
--pr	PR_NUMBER	Yes	Pull request number
--reviewer-token	REVIEWER_TOKEN	Yes	Gitea API token for posting reviews
--llm-base-url	LLM_BASE_URL	Yes	OpenAI-compatible API base URL
--llm-api-key	LLM_API_KEY	Yes	LLM API key
--llm-model	LLM_MODEL	Yes	Model identifier
--reviewer-name	REVIEWER_NAME	No	Display name in review footer
--conventions-file	CONVENTIONS_FILE	No	Path to conventions file in repo
--dry-run	—	No	Print review to stdout instead of posting

Adding to a Gitea Repository

1. Build the binary or use the CI workflow approach (build in CI).

2. Add secrets to your Gitea repo (Settings → Actions → Secrets):

   • SONNET_REVIEW_TOKEN — Gitea token for the Sonnet reviewer account
   • GPT_REVIEW_TOKEN — Gitea token for the GPT reviewer account
   • LLM_BASE_URL — Your LLM API endpoint
   • LLM_API_KEY — Your LLM API key

3. Copy .gitea/workflows/ci.yml to your repo (or adapt it).

4. On every PR, the bot will:

   • Run tests and vet
   • Build review-bot
   • Post reviews from each configured LLM reviewer

Development

# Run tests
go test ./...

# Run vet
go vet ./...

# Build
go build -o review-bot ./cmd/review-bot

# Integration tests (requires env vars)
go test -tags=integration ./...

Architecture

cmd/review-bot/     CLI entrypoint
gitea/              Gitea API client
llm/                OpenAI-compatible LLM client
review/             Prompt building, response parsing, formatting

License

MIT