tmseidel/ai-git-bot repository overview

⁠AI-Git-Bot

• 🔍 Review pull requests
• 🧪 Generate tests
• ✏️ Improve issues
• 🤖 Turn issues into pull requests
• 🎬 Create and run E2E tests
• 📝 Keep documentation in sync with the code
• 🌍 Keep translations in sync across locale files
• 💬 Answer questions inside code reviews

⁠Why does this project exist?

Every engineering team has a list of things they know should happen:

• Pull requests should be reviewed carefully
• Bugs should get regression tests
• Issues should have acceptance criteria
• Documentation should stay up to date with the code
• Preview environments should be cleaned up
• Small maintenance tickets should eventually get implemented

Nobody disagrees with any of those ideas. The problem is that these tasks are:

• Uncomfortable
• Repetitive
• Difficult to prioritize
• Easy to postpone when deadlines get tight

AI-Git-Bot exists to turn these engineering chores into repeatable workflows that happen automatically inside your Git platform.

• No new development process.
• No migration project.
• No vendor lock-in.

Just better engineering hygiene through automation.

⁠🔌 Mix any AI provider with any Git platform

Unlike most AI coding tools, AI-Git-Bot is not tied to a specific Git platform or AI provider. Fully self-hostable. Your code can stay inside your infrastructure.

⁠✨ What can it do?

Every workflow is opt-in per bot — nothing changes for repos you don't touch.

⁠🤖 Issue Agents: Coding and Writer

Two issue-driven agents let you assign bots to issues:

• Coding Agent docs⁠ — configuration, settings, limitations
• Writer Agent docs⁠ — configuration, settings, limitations
• Full agent reference⁠ — all settings, tool-calling, webhook setup

⁠Quick Start

docker run -p 8080:8080 tmseidel/ai-git-bot:latest

Then:

1. Open http://localhost:8080
2. Create your administrator account
3. Create an AI Integration
4. Create a Git Integration
5. Create a Bot
6. Configure the webhook
7. You're done

⁠Docker Compose for customized production setup

services:
  app:
    image: tmseidel/ai-git-bot:latest
    ports:
      - "8080:8080"
    environment:
      SPRING_PROFILES_ACTIVE: docker
      DATABASE_URL: jdbc:postgresql://db:5432/giteabot
      DATABASE_USERNAME: giteabot
      DATABASE_PASSWORD: change-me
      APP_ENCRYPTION_KEY: your-secure-encryption-key
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped

  db:
    image: postgres:17-alpine
    environment:
      POSTGRES_DB: giteabot
      POSTGRES_USER: giteabot
      POSTGRES_PASSWORD: change-me
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U giteabot"]
      interval: 5s
      timeout: 5s
      retries: 5
    restart: unless-stopped

volumes:
  pgdata:

⁠Environment Variables

⁠Agent Configuration (Optional)

⁠Supported AI Providers

All AI configuration (API URLs, keys, models) is managed through the web UI — no environment variables needed beyond what's listed above.

⁠Supported Git Providers

Issue-based agent workflows (coding and writer) require issue assignment and webhook support — Gitea, GitHub, and GitLab. Bitbucket Cloud is PR-review only.

⁠Webhook Setup

Each bot gets a unique webhook URL displayed in the web UI:

• /api/webhook/{webhook-secret}

⁠Supported Events per Platform

⁠Health Check

GET http://<host>:8080/actuator/health

Built-in health check runs every 30s with a 30s start period.

⁠Documentation

• User Guide⁠
• Architecture⁠
• PR Workflows overview⁠
• PR Review⁠
• Agentic PR Review⁠
• Unit Tests⁠
• Full-Stack QA / E2E⁠
• README Sync⁠
• i18n Coverage⁠
• CI Actions / Webhook Recipes⁠
• Coding Agent⁠
• Writer Agent⁠
• Issue Agents reference⁠
• Deployment Guide⁠
• Gitea Setup⁠
• GitHub Setup⁠
• GitLab Setup⁠
• Bitbucket Setup⁠
• Security Policy⁠

⁠Technical Highlights

• 🔒 AES-256-GCM secret encryption
• 🤖 Multi-provider AI support
• 🏢 Multi-platform Git support
• 🧠 Local LLM support
• 🔌 MCP integration
• 🧪 System-tested workflows
• 🐳 Docker-first deployment
• 🌍 Self-hostable end-to-end

⁠License

MIT⁠