Skip to main content

​
Overview

This demo shows how to build an AI agent using the Claude Agent SDK that clones any public GitHub repo and uses Claude to answer questions about its codebase. The agent explores the code using Grep and Read tools to provide detailed, accurate answers.

​
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 – workflow orchestration with real-time streaming, observability, and deployment

​
Demo video

​
GitHub repo

View the Claude GitHub wiki agent repo

Click here to view the full code for this project in our examples repository on GitHub. You can fork it and use it as a starting point for your own project.

​
How it works

The agent workflow:
  1. Receive question – User provides a GitHub URL and question about the repo
  2. Clone repository – Shallow clone to a temp directory (depth=1 for speed)
  3. Analyze with Claude – Agent explores the codebase using allowed tools:
    • Grep – Search for patterns across files
    • Read – Read file contents
  4. Stream response – Analysis streams to the frontend in real-time
  5. Cleanup – Temp directory is always deleted, even on failure

​
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
  • 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 code

FileDescription
trigger/analyze-repo.tsMain task that clones repo, runs Claude agent, and streams response
trigger/agent-stream.tsTyped stream definition for real-time text responses
app/api/analyze-repo/route.tsAPI endpoint that triggers the task
app/response/[runId]/page.tsxReal-time streaming display with progress

​
trigger.config.ts

You need to mark the Claude Agent SDK as external in your trigger.config.ts file.
trigger.config.ts
import { defineConfig } from "@trigger.dev/sdk";

export default defineConfig({
  project: process.env.TRIGGER_PROJECT_REF!,
  runtime: "node",
  logLevel: "log",
  maxDuration: 3600, // 60 minutes for large repos
  build: {
    external: ["@anthropic-ai/claude-agent-sdk"],
  },
  machine: "medium-2x",
});
Adding packages to external prevents them from being bundled, which is necessary for the Claude Agent SDK. See the build configuration docs for more details.

​
Learn more