Coding Agent — Autonomous Bug Fixer

An autonomous agent that monitors your GitHub repository, fixes bugs automatically, and opens Pull Requests — no human in the loop between issue and PR.

Live demo: https://coding-agent-murex.vercel.app

What It Does

• Reads GitHub issues labeled with bug/agent-fix
• Uses an LLM to find the most relevant file(s)
• Generates fixes and runs them in a sandbox
• Validates with generated test cases (retries up to 5 times)
• Creates a surgical patch and opens a Draft PR with confidence score
• Comments the issue with the diff, confidence, and PR link

Architecture

Below is an animated architecture diagram showing the flow from GitHub Issue → Webhook → Backend Agent → LLM → Sandbox → Surgical Patch → Draft PR.

If your viewer doesn't render SVG animation, open the file directly at assets/architecture.svg.

Tech Stack

• Backend: Node.js + Express
• LLM: Groq (Llama 3.3)
• DB: Supabase PostgreSQL + pgvector
• Vector memory: Hugging Face embeddings
• Job queue: pg-boss
• Sandbox: Node.js vm (planned migration to child_process)
• Frontend: Next.js + Tailwind
• Hosting: Render (backend), Vercel (frontend)

Key Features

• Self-improving loop with vector memory and strategy tracking
• Smart file discovery — LLM finds relevant files automatically
• Real validation via generated tests, ESLint, and sandboxed execution
• Surgical patching — only the changed lines are committed
• Cost tracking (API calls, tokens) surfaced in dashboard

Run Locally (Quickstart)

Prerequisites:

• Node.js v18+
• Supabase instance and connection URL
• Groq API key
• GitHub personal access token (repo:scope to create PRs)
• Hugging Face token (for embeddings)

1. Install:

npm install

2. Add environment variables (example .env keys):

• DATABASE_URL
• GROQ_API_KEY
• GITHUB_TOKEN
• HUGGINGFACE_API_KEY

3. Start backend:

cd backend
npm run dev

4. Start frontend:

cd frontend
npm run dev

Files of Interest

• backend/agent.js — core agent loop and LLM orchestration
• backend/index.js — webhook, SSE, metrics endpoints
• frontend/app/page.tsx — dashboard and metrics

Contributing

This project is intended as an experimental autonomous devops/assistant. Please open issues or PRs to suggest improvements — PRs are validated by the existing GitHub Actions pipeline.

License

MIT