Github App

GitHub App: @chrisleekr-bot

A GitHub App that responds to @chrisleekr-bot mentions on pull requests and issues, powered by the Claude Agent SDK. Every event is handed to a daemon for execution; when triage flags a job as heavy or the queue overflows, the orchestrator spawns an ephemeral daemon Pod on demand so one deployment can serve both trivial chores and long-running refactors.

📖 Documentation:

What it does

• Code review: mention the bot on a PR for AI-powered review.
• Code changes: ask it to fix bugs, refactor, or implement features.
• Q&A: ask questions about the codebase on issues or PRs.
• Extensible: add new webhook events or MCP servers without touching the core pipeline.

Architecture at a glance

flowchart LR
    GH["GitHubwebhook"]:::entry
    SRV["Webhook serververify + ack 200"]:::guard
    RTR["Orchestratortriage + queue + scaler"]:::decide
    QUEUE["Job queue"]:::store
    FLEET["Daemon fleetpersistent + ephemeral"]:::target
    AGT["Claude Agent SDKon cloned repo"]:::work
    CMT["Tracking commentresult + cost"]:::done
    GH --> SRV --> RTR --> QUEUE --> FLEET --> AGT --> CMT
    RTR -. spawn ephemeral Podon heavy or overflow .-> FLEET
    classDef entry fill:#0b3d91,stroke:#061d4a,color:#ffffff
    classDef guard fill:#1f6feb,stroke:#0b3d91,color:#ffffff
    classDef decide fill:#8250df,stroke:#4b1d99,color:#ffffff
    classDef store fill:#d29922,stroke:#7d5c00,color:#1a1a1a
    classDef target fill:#1a7f37,stroke:#0b4a1e,color:#ffffff
    classDef work fill:#bf3989,stroke:#71204f,color:#ffffff
    classDef done fill:#2da44e,stroke:#0b4a1e,color:#ffffff

See Architecture for the full flow, including idempotency, triage, and the pipeline stages.

Quick start

cp .env.example .env            # Fill in credentials
bun install
bun run dev:deps                # Local Valkey + Postgres (required for the orchestrator)
bun run dev                     # Watch mode

Full setup, configuration reference, architecture diagrams, and deployment recipes live in the documentation site.

Documentation

The docs site is built from Markdown in docs/ using MkDocs Material. To preview locally:

bun run docs:install            # One-time: pip install -r docs/requirements.txt
bun run docs:serve              # Live reload at http://localhost:8000
bun run docs:build              # Strict build, run before opening a doc PR

Contributing

See [CONTRIBUTING.md](./CONTRIBUTING.md) for local setup, testing, linting, and commit message conventions. Any PR that touches env-var validation, dispatch logic, or MCP surfaces must update the matching page under docs/ in the same change, see the ## Documentation section of [CLAUDE.md](./CLAUDE.md).

License

MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: chrisleekr
• Source: chrisleekr/github-app
• License: MIT
• Homepage: https://chrisleekr.github.io/github-app/

Install and usage instructions live in the source repository linked above.