CI-Copilot
CI-Copilot is a multi-agent framework that generates, modifies, and debugs CI/CD pipelines through conversation. It works like a senior engineer available to everyone — you describe what you need, and it handles detection, planning, validation, rendering, and commit.
Status
| Aspect | Details |
|---|---|
| Status | ✅ Ready |
| Maintained By | TalkOps Team |
| Protocol | Google A2A Protocol |
| Framework | LangGraph Multi-Agent |
| GitHub | talkops-ai/ci-copilot |
| Docker | talkopsai/ci-copilot |
Why CI-Copilot?
The problem. Most teams have one or two people who actually know how the CI system works — how to structure jobs, which actions to trust, how to wire up caching, where the gotchas are in Jenkins vs. GitHub Actions. Everyone else copies YAML from another repo and hopes it works. When something breaks, the same senior engineers get pulled in. And if the org decides to move platforms, the whole thing gets rewritten from scratch.
Meanwhile, CI/CD is just the start. Teams also need build and release pipelines, infra automation jobs, scheduled maintenance tasks, deployment workflows — all of which follow the same pattern: someone senior configures it once, and everyone else is afraid to touch it.
What CI-Copilot brings to the table.
CI-Copilot isn't limited to CI/CD pipelines. It can create any kind of job or workflow you'd normally need a senior engineer to set up — whether that's a CI pipeline, a build and release workflow, an infrastructure automation job, or a scheduled maintenance task. You describe what you need, and it handles the rest: detection, planning, rendering, validation, and commit.
Three things make this different:
-
It works like a senior engineer, available to everyone. A junior DevOps engineer using CI-Copilot gets access to the same depth of knowledge — best practices, platform-specific nuances, security patterns, caching strategies — that would normally take years to build up. It levels the playing field.
-
It's not just CI/CD. Need a nightly database backup job in Jenkins? A Terraform plan-and-apply workflow in GitHub Actions? A release pipeline with approval gates? CI-Copilot can build it. The system understands CI platforms deeply, not just one narrow use case.
-
It reduces the need for a dedicated team. When any engineer can generate, modify, and debug workflows through conversation — with governance and approval gates built in — you no longer need a dedicated CI/CD or build & release team to handle every request. The bottleneck disappears.
Under the hood, it's a multi-agent system where each capability (detection, validation, rendering) is a separate agent that can be extended or replaced independently. And nothing gets committed without your explicit approval — governance is baked in, not bolted on.
Key Features
Available now:
- Intelligent context detection — scans your repo to identify runtime, package manager, dependencies, Dockerfiles, and existing CI configs across 8 languages
- CI intent inference — builds a structured pipeline spec (CISpec) with stages, capabilities, enforcement levels, and triggers via LLM analysis
- Policy validation — validates the plan against security policies, license compliance, and best practices before rendering
- Production-ready rendering — generates idiomatic GitHub Actions YAML with proper action versions, caching, and dependency graphs
- Self-correcting refinement — validates with
actionlint, checks schema compliance, and auto-corrects through a reflection loop - Automated PR creation — commits the workflow and opens a pull request directly on your repo
- Human-in-the-loop governance — approval gates after plan generation and before the final commit
- Rich interactive UI — A2UI-powered components for CI plan review, pipeline summaries, and approval workflows
Coming soon:
- Multi-platform support — generate pipelines for Jenkins, GitLab CI, CircleCI, Azure Pipelines, and more from the same intent
- Workflow modification — modify and update existing pipelines through conversation, platform-agnostic
- Job debugging — diagnose and fix failing CI jobs from a prompt
- CI knowledge base — deep, built-in expertise across CI platforms for troubleshooting and optimization
Architecture
The system is a hierarchy of agents built with LangGraph, communicating via the A2A protocol.
The flow in practice:
- You ask for a CI pipeline (e.g.
"Create GitHub Actions for my-org/payments-api") - Context Detector connects to GitHub via MCP, fetches the repo, and analyzes it — language, runtime version, dependencies, test/lint tools, Dockerfiles, existing CI
- It builds a CI specification and presents a plan for your approval
- Policy Validator checks the plan against security and compliance rules
- Renderer converts the spec to GitHub Actions YAML, validates with
actionlint, and refines through a reflection loop - You review the final output. On approval, it commits to a branch and opens a PR
Tech Stack
| Category | Technologies |
|---|---|
| Agent Framework | LangChain + LangGraph |
| Language | Python 3.12+ |
| CI Platform | GitHub Actions |
| LLM Providers | OpenAI · Anthropic · Google Gemini · AWS Bedrock · Azure OpenAI |
| Protocol | A2A · A2UI |
| GitHub Integration | GitHub MCP Server |
| Validation | actionlint · ruamel.yaml |
| Infrastructure | Docker · uv · Uvicorn · Starlette |
Prerequisites
| Requirement | Details |
|---|---|
| Python | 3.12+ |
| LLM API Key | OpenAI, Anthropic, or another supported provider |
| GitHub PAT | Personal Access Token with repo scope |
| Docker | For Docker Compose quick start |
Quick Start
Docker Compose (recommended)
# 1. Create docker-compose.yml and .env (see Configuration)
docker compose up -d
# CI-Copilot running at http://localhost:10102
# TalkOps UI running at http://localhost:8080
From Source
git clone https://github.com/talkops-ai/ci-copilot.git
cd ci-copilot
uv venv --python=3.12
source .venv/bin/activate
uv pip install -e .
cp .env.example .env
# Edit .env — set OPENAI_API_KEY and GITHUB_PERSONAL_ACCESS_TOKEN
uv run --active ci-copilot \
--host localhost \
--port 10102 \
--agent-card ci_copilot/card/ci_copilot.json
Example Requests
| Request | What You'll See |
|---|---|
| "Create CI/CD pipeline for talkops-ai/ci-copilot" | Detection → plan approval → YAML generation → commit approval → PR |
| "Setup CI for my-org/payments-api with security scanning and 80% coverage" | Customized pipeline with specified capabilities |
| "Create GitHub Actions for my-org/app" | Full flow with human-in-the-loop gates |
Links
| Resource | URL |
|---|---|
| GitHub | talkops-ai/ci-copilot |
| Docker Hub | talkopsai/ci-copilot |
| Discord | Join Community |