Skip to content

README.md

Latest commit

 

History

History
61 lines (42 loc) · 2.56 KB

README.md

File metadata and controls

61 lines (42 loc) · 2.56 KB

Changelog generator using the Claude Agent SDK and Trigger.dev

An AI agent that explores GitHub commits, investigates unclear changes by fetching diffs on demand, and generates developer-friendly changelogs. Built with the Claude Agent SDK and Trigger.dev.

Tech Stack

  • Next.js – Frontend framework using App Router
  • Claude Agent SDK – Anthropic's agent SDK for building AI agents with custom tools
  • Trigger.dev – Background task orchestration with real-time streaming to the frontend, observability, and deployment.
  • Octokit – GitHub API client for fetching commits and diffs.

Demo

claude-changelog-generator.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
    • GITHUB_TOKEN (optional) – For private repos, needs repo scope

  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 to see the demo

Features

  • Two-phase analysis – Lists all commits first, then selectively fetches diffs only for ambiguous ones to minimize token usage
  • Custom MCP tools – list_commits and get_commit_diff called autonomously by Claude
  • Real-time streaming – Changelog streams to the frontend as it's generated via Trigger.dev Realtime
  • Live observability – Agent phase, turn count, and tool calls broadcast via run metadata
  • Markdown rendering – Streamed output formatted with Streamdown and Shiki syntax highlighting
  • Private repo support – Optional GitHub token for private repositories

Relevant Files