GitHub App that responds to @chrisleekr-bot mentions on PRs and issues — powered by Claude Agent SDK.
Ported from claude-code-action tag mode to a standalone webhook server.
- Code review: Mention
@chrisleekr-boton a PR for AI-powered code review - Code changes: Ask the bot to fix bugs, refactor, or implement features
- Q&A: Ask questions about the codebase on issues or PRs
- Extensible: Add new webhook events, MCP servers, or behaviors
See docs/SETUP.md for the full GitHub App creation and configuration guide.
cp .env.example .env # Fill in credentials (see SETUP.md for details)
bun install
bun run devsequenceDiagram
actor User
participant GitHub
participant Bot as Bot Server
participant Claude as Claude Agent SDK
participant MCP as MCP Servers
User->>GitHub: Mentions @chrisleekr-bot<br/>in a PR or issue comment
GitHub->>Bot: POST /api/github/webhooks
Bot-->>GitHub: 200 OK (responds immediately)
Note over Bot,Claude: Heavy work runs asynchronously after 200 OK
Bot->>GitHub: Creates "Working..." tracking comment
Bot->>GitHub: Fetches PR/issue context via GraphQL
Bot->>GitHub: Clones repository (shallow, branch-specific)
Bot->>Claude: Runs agent with full prompt and cloned repo
loop Until task complete
Claude->>MCP: Calls tools (read/write files, post comments, create inline reviews)
MCP->>GitHub: Updates tracking comment / posts inline review
end
Bot->>GitHub: Finalizes tracking comment with result summary
See CLAUDE.md for a quick architecture overview and docs/ARCHITECTURE.md for the full request-flow diagram and directory structure.
See docs/DEPLOYMENT.md for Docker build args, health probes, resource sizing, and graceful shutdown details.
See docs/EXTENDING.md for how to add new webhook event handlers and MCP servers.
See CONTRIBUTING.md for local setup, testing, linting, and commit message conventions.
Private