claude-agent-github-wiki

GitHub repository analyzer agent using Claude and Trigger.dev

Ask questions about any public GitHub repository and get AI-powered analysis using the Claude Agent SDK for agentic exploration and Trigger.dev for real-time streaming to the frontend.

Tech stack

• Next.js – React framework with App Router for the frontend
• Claude Agent SDK – Anthropic's SDK for building AI agents with file system and search tools
• Trigger.dev – Background task orchestration with real-time streaming to the frontend, observability, and deployment

Demo video

claude-github-wiki.mp4

Running the project locally

1. Install dependencies

   npm install

2. Configure environment variables

   cp .env.example .env

   • TRIGGER_SECRET_KEY – From Trigger.dev dashboard
   • TRIGGER_PROJECT_REF – Your project ref (starts with proj_)
   • ANTHROPIC_API_KEY – From Anthropic Console

3. Start development servers

   # Terminal 1: Next.js
   npm run dev
   
   # Terminal 2: Trigger.dev
   npx trigger.dev@latest dev

4. Open http://localhost:3000 in your browser

Features

• Ask anything about any public repo – Architecture, security vulnerabilities, API endpoints, testing strategies, etc.
• Claude Agent SDK exploration – Claude explores the codebase using Grep and Read tools to provide detailed answers
• Cancel anytime – Abort long-running tasks with proper cleanup
• Trigger.dev Realtime streaming – Watch Claude's analysis stream in as it's generated
• Progress tracking – See clone status, analysis progress, and repo size via Trigger.dev metadata

Relevant files

• trigger/analyze-repo.ts – Main task that clones repo, runs Claude agent, and streams response
• trigger/agent-stream.ts – Typed stream definition for real-time text responses
• app/api/analyze-repo/route.ts – API endpoint that triggers the task and returns a public access token
• app/response/[runId]/page.tsx – Real-time streaming display with progress
• trigger.config.ts – Project config with external SDK bundle