# Broccoli OSS

> Broccoli turns Linear tickets into shipped PRs — powered by Claude and Codex, running on your own Google Cloud infrastructure.

Broccoli OSS is an open-source AI engineering automation tool that converts Linear tickets into reviewable pull requests using Claude and Codex, deployed entirely on your own Google Cloud Platform. It runs as two Cloud Run workloads — a FastAPI webhook service and a Cloud Run Job runner — backed by Postgres and Secret Manager, keeping all data within your own GCP tenancy. The tool deploys in approximately 30 minutes via a single bootstrap script and supports AI code review on every PR. There is no third-party control plane; your infrastructure, your keys, your data.

- **Linear ticket → PR automation**: *Assign an issue to the Broccoli bot and it plans, implements, and opens a pull request automatically.*
- **AI code review**: *Claude and Codex read your diffs, leave actionable comments, and push fix commits on request.*
- **Self-hosted on GCP**: *Deploys to your own Google Cloud project using Cloud Run, Cloud SQL, and Secret Manager — no data leaves your tenancy.*
- **Durable job state**: *Serverless Cloud Run with webhook deduplication and Postgres-backed job state ensures production-grade reliability.*
- **Customizable prompt templates**: *Start with opinionated vendored templates, then fork, tune, and version them alongside your code.*
- **Codex-driven deployment**: *Paste a single prompt to your coding agent (e.g., Codex CLI) to drive the full GCP deployment interactively.*
- **Operator tooling**: *Built-in CLI commands for migrations, seeding repo config, preflight checks, and smoke tests.*
- **Pluggable database backend**: *Defaults to Cloud SQL but supports any external Postgres via `DATABASE_URL`.*
- **Webhook routing**: *Routes Linear issues to the correct repo by label, bot user assignment, and estimate thresholds.*
- **MIT licensed**: *Free to use, modify, and distribute under the MIT License.*

## Features
- Linear ticket to PR automation
- AI code review on every PR
- Self-hosted on Google Cloud Platform
- Claude and Codex LLM integration
- Serverless Cloud Run deployment
- Webhook deduplication
- Durable Postgres-backed job state
- Secret Manager integration
- Customizable prompt templates
- Codex CLI deployment skill
- Operator CLI for migrations and seeding
- Preflight and smoke test tooling
- Webhook routing by label and bot user
- Cloud SQL and external Postgres support
- GitHub App integration
- Linear webhook integration

## Integrations
Linear, GitHub, Google Cloud Run, Google Cloud SQL, Google Cloud Secret Manager, Google Cloud Build, Anthropic Claude, OpenAI Codex, PostgreSQL

## Platforms
API, CLI

## Pricing
Open Source

## Version
v0.1.0

## Links
- Website: https://github.com/besimple-oss/broccoli
- Documentation: https://github.com/besimple-oss/broccoli/blob/main/ARCHITECTURE.md
- Repository: https://github.com/besimple-oss/broccoli
- EveryDev.ai: https://www.everydev.ai/tools/broccoli-oss