Skip to content

Home

Jump to bottom
GSD Planner edited this page May 26, 2026 · 2 revisions

ci-autopilot

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

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

How It Works

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
  1. A GitHub Actions workflow fails
  2. autopilot-failure-intake.yml captures the failure as a queued issue
  3. agent/poll_once.py polls the issue queue on the self-hosted runner
  4. The agent dispatches the repair task to Codex
  5. Codex opens a PR with the fix; CI must pass before merge

Wiki Pages

Page Description
Setup Guide Runner registration, prerequisites, local development
Architecture System design, component descriptions, data flow
Configuration Reference Secrets, tokens, operations runbook

Repository Links

Key Files

File Purpose
agent/poll_once.py Python 3.12 stdlib agent — polls issue queue and dispatches repairs
.github/workflows/fixer.yml Main CI autopilot workflow (self-hosted runner)
.github/workflows/autopilot-failure-intake.yml Captures workflow failures as queued issues
.github/workflows/ci.yml Python 3.12 syntax check CI (badge on main)
docs/ Full documentation set (7 pages + GitHub Pages site)

Ecosystem

Part of the Coding-Autopilot-System ecosystem:

  • gsd-orchestrator — GSD autonomous workflow orchestrator (.NET 10)
  • Promptimprover — AI prompt refinement service (Node.js/TypeScript)
  • autogen — Multi-agent orchestration runtime (Python 3.12)

Clone this wiki locally