Autonomous AI Agent that reads GitHub issues & maintainer review comments, performs multi-file code fixes, creates test suites, audits diffs, drafts human-like PRs, and auto-fixes CI check failures.
- 8-Phase Contributor Pipeline:
- Review & Intent Analysis: Classifies feedback, root causes, tech stack, and target files.
- Multi-File Implementation: Generates coordinated bug fixes across multiple source files.
- Regression Testing: Builds matching test files (
jest,vitest,pytest,go_test). - Diff Self-Audit: Audits syntax, type safety, and prevents regressions.
- CI Compliance: Validates conventional commit & branch naming standards.
- Maintainer Satisfaction Matrix: Verifies 100% resolution with explicit evidence.
- Atomic PR Creation: Creates branch, forks if needed, commits files, and opens PR.
- CI Monitoring & Remediation: Polls GitHub Actions check runs and auto-pushes fixes if tests fail.
- Autonomous Webhook Triggering: Listen to
issues.openedandpull_request_review.submittedvia/api/webhook. - Multi-Model Inference Cascade: Google Gemini SDK -> NVIDIA NIM (Llama 3.1 / Nemotron) -> GitHub Models with automatic fallback.
-
Clone repository and install dependencies:
npm install
-
Configure Environment Variables: Copy
.env.local.exampleto.env.localand add your keys:cp .env.local.example .env.local
Required keys:
GITHUB_TOKEN: GitHub Personal Access Token (withrepo,workflowscopes).GEMINI_API_KEY: Google Gemini API Key.NVIDIA_API_KEY(Optional): NVIDIA NIM API key for fallback inference.GITHUB_WEBHOOK_SECRET(Optional): Secret for webhook payload verification.
-
Run development server:
npm run dev
Open http://localhost:3000 in browser.
-
Autonomous Webhook Configuration: In your target GitHub repository:
- Go to Settings -> Webhooks -> Add webhook
- Payload URL:
https://your-domain.com/api/webhook - Content type:
application/json - Events: Select Issues and Pull request reviews