OpenCode Gitea Review

中文文档 | English

An AI-powered automatic code review tool for Gitea/Forgejo PRs, built on the OpenCode plugin system. It listens for PR and comment events via Gitea Actions, automatically fetches code diffs, and submits structured reviews.

✨ Features

• 🤖 AI-Powered Code Review - Uses Claude/GPT/DeepSeek models to analyze code changes
• 📝 Line-Level Comments - Provides precise feedback on specific code lines
• ✅ Review Decisions - Supports approve, request_changes, and comment states
• 🔄 Auto-Trigger - Triggered by /oc or /opencode comments
• � Incremental Review - Only reviews new changes since last review (for updated PRs)
• 🏷️ Structured Tags - Categorizes issues by type (BUG, SECURITY, PERFORMANCE) and severity
• �🐳 Docker Support - Zero-config installation with pre-built image
• 🛡️ Isolated Configuration - Uses .opencode-review/ directory, won't conflict with your existing .opencode/ setup

📦 Installation

Interactive Installation (Recommended)

Run in your project root:

curl -fsSL https://raw.githubusercontent.com/ccsert/opencode-review-gitea/main/install.sh | bash

You'll see an interactive menu to choose your installation method.

Direct Installation Options

# Docker-based (Recommended) - Zero files added to repo
curl -fsSL https://raw.githubusercontent.com/ccsert/opencode-review-gitea/main/install.sh | bash -s -- --docker

# Source-based - Full customization
curl -fsSL https://raw.githubusercontent.com/ccsert/opencode-review-gitea/main/install.sh | bash -s -- --source

# Both methods
curl -fsSL https://raw.githubusercontent.com/ccsert/opencode-review-gitea/main/install.sh | bash -s -- --both

🔄 Installation Methods Comparison

⚙️ Configuration

1. Set Up Secrets

Configure the following secrets in your Gitea repository:

2. Configure Model (Optional)

Edit .gitea/workflows/opencode-review.yaml:

env:
  # Format: provider/model-id
  MODEL: deepseek/deepseek-chat        # Default (requires DEEPSEEK_API_KEY)
  # MODEL: anthropic/claude-sonnet-4-5  # Requires ANTHROPIC_API_KEY
  # MODEL: openai/gpt-4o                # Requires OPENAI_API_KEY

3. Using LLM Gateways (Optional)

You can use LLM gateways like LiteLLM, OpenRouter, Together AI, NVIDIA NIM, etc. via the OpenAI-compatible API:

env:
  # Point MODEL to an OpenAI-compatible provider
  MODEL: openai/your-model-name
  OPENAI_API_KEY: ${{ secrets.YOUR_API_KEY }}
  # Set the gateway URL
  OPENAI_BASE_URL: "https://openrouter.ai/api/v1"    # OpenRouter
  # OPENAI_BASE_URL: "http://localhost:4000/v1"        # LiteLLM
  # OPENAI_BASE_URL: "https://api.together.xyz/v1"     # Together AI

Note: When using gateways, set MODEL to openai/<model-name> so opencode routes through the OpenAI-compatible provider.

4. Review Configuration

These options work with both Docker and Source installations:

env:
  # Response language
  REVIEW_LANGUAGE: auto      # auto | en | zh-CN
  
  # Review depth and focus
  REVIEW_STYLE: balanced     # concise | balanced | thorough | security
  
  # File filtering (glob patterns, comma-separated)
  FILE_PATTERNS: ""          # e.g., "*.ts,*.go,src/**" (empty = all files)

Language Options

File Filtering Examples

# Only review TypeScript files
FILE_PATTERNS: "*.ts,*.tsx"

# Only review source files (exclude tests)
FILE_PATTERNS: "src/**/*.go"

# Multiple patterns
FILE_PATTERNS: "*.py,*.js"

# Note: currently only positive matching is supported (no leading '!').

🚀 Usage

Trigger Code Review

Comment on a PR:

/oc

or

/opencode please review this PR

Local Testing (Docker)

docker run --rm \
  -v $(pwd):/workspace \
  -e GITEA_TOKEN="your-token" \
  -e GITEA_SERVER_URL="https://your-gitea.example.com" \
  -e DEEPSEEK_API_KEY="your-key" \
  -e PR_NUMBER=123 \
  -e REPO_OWNER="your-org" \
  -e REPO_NAME="your-repo" \
  ghcr.io/ccsert/opencode-review:latest

REPO_NAME can be either repo or owner/repo (entrypoint will normalize it).

Note: The Docker image currently only supports x86_64/amd64 architecture. ARM devices (Raspberry Pi, etc.) should use the Source installation method instead.

Local Testing (Source)

export GITEA_TOKEN="your-token"
export GITEA_SERVER_URL="https://your-gitea.example.com"
export OPENCODE_CONFIG_DIR="$(pwd)/.opencode-review"

opencode run --agent code-review \
  "Please review PR #123 in owner/repo"

🔧 Customization (Source Installation)

Modify Review Style

Edit .opencode-review/agents/code-review.md:

---
description: AI code reviewer for Gitea/Forgejo PRs
tools:
  "*": false
  "gitea-review": true
  "gitea-pr-diff": true
---

You are a code review expert focusing on [your domain]...

Add New Tools

Create a TypeScript file in .opencode-review/tools/:

import { tool } from "@opencode-ai/plugin"

export default tool({
  description: "Tool description",
  args: {
    param: tool.schema.string().describe("Parameter description"),
  },
  async execute(args, context) {
    return "Result"
  },
})

📁 Project Structure

.
├── Dockerfile                      # Docker image definition
├── docker-compose.yaml             # Local testing
├── entrypoint.sh                   # Container entrypoint
├── install.sh                      # Installation script
├── templates/
│   ├── workflow-docker.yaml        # Docker workflow template
│   └── workflow-source.yaml        # Source workflow template
├── .github/workflows/
│   └── docker-publish.yaml         # Auto-build Docker image
└── .opencode-review/               # Isolated config directory
    ├── agents/
    │   ├── code-review.md          # Code review agent (main)
    │   └── gitea-assistant.md      # General assistant agent
    ├── tools/
    │   ├── gitea-pr-diff.ts        # Get full PR diff
    │   ├── gitea-pr-files.ts       # List changed files
    │   ├── gitea-incremental-diff.ts # Get incremental diff (new changes only)
    │   ├── gitea-review.ts         # Submit review with comments
    │   └── gitea-comment.ts        # Post comments on issues/PRs
    ├── skills/
    │   └── pr-review/SKILL.md      # Reusable review skill
    └── package.json                # Dependencies

Note: After installation, .gitea/workflows/opencode-review.yaml will be created in your project.

🔗 Related Links

• OpenCode Documentation
• OpenCode Custom Tools
• Gitea API Documentation
• Docker Image

📄 License

MIT License - See LICENSE