# review-bot

AI-powered code review bot for Gitea pull requests.

## Overview

`review-bot` fetches a PR's diff, title, description, and CI status from Gitea, sends it to an LLM via an OpenAI-compatible API, and posts a structured code review back to Gitea.

## Usage

```bash
review-bot \
  --gitea-url https://gitea.weiker.me \
  --repo owner/name \
  --pr 123 \
  --reviewer-name "sonnet-review-bot" \
  --reviewer-token "$(cat /path/to/token)" \
  --llm-base-url "https://proxy.example.com/v1" \
  --llm-api-key "key" \
  --llm-model "anthropic--claude-4.6-sonnet" \
  --conventions-file "CLAUDE.md"
```

All flags can also be set via environment variables:

| Flag | Env Var |
|------|---------|
| `--gitea-url` | `GITEA_URL` |
| `--repo` | `GITEA_REPO` |
| `--pr` | `PR_NUMBER` |
| `--reviewer-name` | `REVIEWER_NAME` |
| `--reviewer-token` | `REVIEWER_TOKEN` |
| `--llm-base-url` | `LLM_BASE_URL` |
| `--llm-api-key` | `LLM_API_KEY` |
| `--llm-model` | `LLM_MODEL` |
| `--conventions-file` | `CONVENTIONS_FILE` |

Use `--dry-run` to print the review to stdout without posting.

## Build

```bash
go build -o review-bot ./cmd/review-bot
```

## Architecture

- `cmd/review-bot/main.go` — CLI entry point
- `gitea/client.go` — Gitea API interactions (fetch PR, diff, CI status, post review)
- `llm/client.go` — OpenAI-compatible chat completion client
- `review/prompt.go` — System/user prompt construction
- `review/parser.go` — Parse LLM JSON response
- `review/formatter.go` — Format markdown review body

## Constraints

- Pure Go stdlib, no external dependencies
- No CGO