my-agent

AI Code Review Agent

What It Is About

• An agentic, multi-step code review tool that is powered by Gemini 2.5 Flash and Vercel AI SDK. This a pure code reviewer. With a preset prompt - just point it to a directory containing your code!

Key Design Decisions

• Agentic loop (stopWhen: stepCountIs(10)) — the model can invoke tools and self-correct across multiple reasoning steps before producing a final answer, rather than a single one-shot pass.
• Streaming output — feedback appears in real time as the model reasons, rather than waiting for a full completion
• Structured system prompt — the reviewer persona is scoped to 8 engineering dimensions with explicit tone and style guidance, producing consistent, actionable feedback rather than generic commentary.
• Bun runtime — chosen for its native TypeScript execution and fast startup, removing the transpile step during development

Stack

Feature	Stack
Language	TypeScript
Runtime	Bun
AI Model	Gemini 2.5 Flash (@ai-sdk/google)
Agent Framework	Vercel AI SDK (ai)
Tools	Custom filesystem tool (tools.ts)

Get Started

To install dependencies:

bun install

# Export Gemini AI Key
export GOOGLE_GENERATIVE_AI_API_KEY=your_key_here

To run:

bun run index.ts

To change which directory is reviewed, edit the prompt at the bottom of index.ts.

Roadmap

• CLI flag for target directory (--dir)
• Output to markdown file (--output report.md)
• GitHub PR integration via API
• Support for additional models (Claude, GPT-4o)
• Web UI for review output

Author

Tadala N. Kapengule | |