ci-autopilot

AI-powered CI autopilot — detects GitHub Actions failures and autonomously dispatches repairs via a Python agent

Overview

ci-autopilot is an AI-powered CI repair agent that monitors GitHub Actions workflows, detects failures, triages them via an issue queue, and dispatches autonomous repairs using a Python agent backed by Codex. It runs on a self-hosted runner and coordinates the full lifecycle from failure detection to merged fix.

The agent (agent/poll_once.py) is a Python 3.12 stdlib-only program that polls the issue queue, picks up queued repair tasks, and dispatches them to the Codex repair pipeline. No external dependencies are required.

Architecture

flowchart LR
    A["GitHub Actions\nfailure detected"] --> B["autopilot-failure-intake\n(intake workflow)"]
    B --> C["Issue queue\n(runner-offline label)"]
    C --> D["agent/poll_once.py\n(Python 3.12)"]
    D --> E["Codex\n(repair dispatch)"]
    E --> F["PR / fix\ncommitted"]

Loading

Core components:

• autopilot-failure-intake.yml — Intake workflow triggered on workflow_run failure events; creates a queued issue
• autopilot-create-issue.yml — Creates GitHub issues via actions/github-script when monitored workflows fail
• fixer.yml — Main CI autopilot; runs agent/poll_once.py on the self-hosted Windows runner
• agent/poll_once.py — Python 3.12 stdlib agent; polls the issue queue and dispatches repairs
• runner-smoke-test.yml — Smoke tests the self-hosted runner on demand
• runner-health.yml — Manual runner health check (dispatch only)

Quick Start

# Prerequisites: Python 3.12, GitHub CLI, GH_TOKEN env var
export GH_TOKEN=<your_token>
python -m agent.poll_once

For full runner registration, service setup, and local development instructions see the Setup Guide wiki page.

Documentation

Source	Description
docs/architecture.md	System architecture and design goals
docs/runner-setup.md	Runner registration and service setup
docs/operations.md	Day-2 operations runbook
docs/security.md	Security posture and access model
docs/control-plane.md	Failure intake and issue control plane
GitHub Pages	Professional docs landing page

Wiki: Home | Setup Guide | Architecture | Configuration Reference

Ecosystem

Part of the Coding-Autopilot-System ecosystem: gsd-orchestrator | Promptimprover | autogen