RepoPulse Agent
AI Codebase Intelligence & Safe Change Planning
Connect a GitHub repo, ask grounded questions, plan a change, review the AI's diff, and generate a final engineering report — nothing is applied without human approval.
The Story
GitHub sits on top of millions of repositories — practically the entire open-source world — yet I was only ever using it the boring way: cloning code, scrolling through files, hunting through pull requests. One night, trying to ramp up on an unfamiliar codebase, I caught myself wishing I could just ask the repo what it did instead of reading it line by line.
That frustration turned into a goal: make GitHub something you could point real intelligence at — and not just my projects, but any repository on GitHub — without ever blindly trusting what an AI handed back.
So I built RepoPulse Agent. You connect a repo and it indexes the codebase, answers grounded questions with cited source context, plans changes, generates reviewable diffs, and routes everything through a human approval gate — all backed by 170+ unit tests over a deterministic core.
The result is a platform where you can interrogate any GitHub repo and trust the output: it never auto-merges code, every answer traces back to the files it came from, and each run turns into a shareable engineering report.
At its simplest, RepoPulse Agent lets you point an AI at a GitHub repository and trust what comes back. It is an AI codebase intelligence and safe change-planning platform: it indexes a repository, answers grounded questions with source context, plans code changes, generates reviewable diffs, requires human approval, and produces stakeholder-facing engineering reports — without ever automatically merging code.
Problem
AI coding tools either hallucinate answers about code they haven't read or silently apply changes nobody reviewed. RepoPulse Agent does neither: every answer cites the indexed source files it came from, and every proposed change passes a safety gate and an approve/reject workflow before anything happens.
Technical Depth
- Deterministic repository indexing first, AI second — file classification, framework detection, and architecture mapping are rule-based and unit-tested, so answers ground in facts
- Grounded Q&A with cited source context: multi-stage retrieval over the indexed tree, with confidence scores per answer
- Safety gate that classifies and refuses destructive or review-bypassing requests before any AI call
- Multi-provider AI layer (OpenAI gpt-4o-mini, Groq, Anthropic, deterministic mock) with budget guard, prompt caching, and per-call cost tracking
Key Features
- End-to-end agent workflow: Index → Ask → Plan → Diff Review → Verify → Approve → Report
- Change planner producing risk/test/rollback plans and per-file proposed diffs with approve/reject decisions
- Sandbox verification that trial-runs only human-approved patches in an isolated clone, comparing baseline vs patched results — the original repository is never modified
- Final Engineering Report summarizing the whole run (plan, diffs, approvals, verification, conclusion) with exportable Markdown
- Agent run history and audit logging of every plan, diff, refusal, and approval decision
- 170+ unit tests (Vitest) over the deterministic core: classification, retrieval, safety, sandbox, and cost controls
Why It Matters
Teams want AI leverage on unfamiliar codebases without losing review control. RepoPulse keeps humans responsible for every decision, makes weak AI output visible through verification gates, and turns each run into a shareable engineering record — the safe-workflow pattern real engineering orgs need before trusting AI with code.
Tech Stack
- Next.js
- TypeScript
- React
- GitHub API
- OpenAI
- Tailwind CSS
- Vitest
Live at repopulse.live. Demo video coming soon.