AI DevOps Agent

Config-driven CI/CD control plane: detects commits via GitHub webhooks, generates missing Dockerfile/compose/workflow files (proposed via PR, never overwritten), and tracks build/deploy/health-check/rollback history reported back by a generated GitHub Actions workflow that runs on your existing self-hosted runners. See docs/architecture.md for the full design.

Quick start (local dev)

npm install
cp .env.example packages/server/.env   # fill in GITHUB_PAT, GITHUB_WEBHOOK_SECRET, etc.
npm run prisma:migrate
npm run dev:server      # http://localhost:4000
npm run dev:dashboard   # http://localhost:5173 (proxies /api to :4000)

Onboard a repo

See docs/onboarding-a-repo.md.

Verify the pipeline mechanics without touching real infra

./scripts/verify-mvp-locally.sh

Builds/pushes/deploys a disposable sample app against a local registry, forces a failed health check, and confirms rollback actually restores the previous version. Requires Docker to allow localhost:5000 as an insecure registry (see script header).

Package layout

• packages/shared - types shared by server and dashboard
• packages/server - Fastify API, Prisma/SQLite, GitHub integration, template generation
• packages/dashboard - React/Vite dashboard

Docs

• docs/architecture.md - what runs in GitHub Actions vs. the central service
• docs/onboarding-a-repo.md - step-by-step repo setup
• docs/security.md - secrets, trust boundaries, logging redaction