Kodiai is an installable GitHub App that delivers AI-powered code review, conversational assistance, issue intelligence, and Slack integration. One installation replaces per-repo workflow YAML — configure behavior with an optional .kodiai.yml file.
25 milestones shipped (v0.1 through v0.25). See CHANGELOG.md for release history.
- Bun runtime
- PostgreSQL with the pgvector extension
- A GitHub App with webhook secret and private key
- A VoyageAI API key for embeddings
# Clone and install
git clone https://github.com/xbmc/kodiai.git
cd kodiai
bun install
# Configure environment
cp .env.example .env
# Edit .env with your credentials — see .env.example for all 26 variables
# Start the dev server
bun run devThe server exposes:
| Endpoint | Purpose |
|---|---|
POST /webhooks/github |
GitHub webhook receiver |
POST /webhooks/slack/events |
Slack events receiver |
GET /healthz |
Liveness probe |
GET /readiness |
Readiness probe |
Kodiai runs as a Bun + Hono HTTP server backed by PostgreSQL with pgvector for hybrid retrieval. It uses multi-model LLM routing via Vercel AI SDK, VoyageAI embeddings, and deploys to Azure Container Apps.
The system processes GitHub webhooks through a job queue with per-installation concurrency limits, uses ephemeral shallow clones for code analysis, and executes agentic tasks via the Vercel Agent SDK with in-process MCP servers.
For the full architecture walkthrough — components, data flow, retrieval pipeline, and extension points — see docs/architecture.md.
Code Review — Automatic PR review with inline suggestions, draft-aware tone, incremental re-review on changed hunks, dependency bump deep-review, CI failure recognition, and risk-weighted file prioritization for large PRs.
@kodiai Mentions — Conversational responses to @kodiai across issue comments, PR comments, and review threads with context-aware follow-ups.
Issue Intelligence — Auto-triage with template validation, label recommendations, duplicate detection, troubleshooting synthesis from resolved issues, and PR creation from issues via apply:/change: commands.
Slack Integration — Thread-based assistant in #kodiai with read-only default, explicit write-mode activation, and high-impact confirmation gating.
Knowledge System — 5-corpus hybrid retrieval (code, review comments, wiki, code snippets, issues) with BM25 + vector search and Reciprocal Rank Fusion merging.
Epistemic Guardrails — 3-tier knowledge classification with severity demotion for unverifiable claims, applied across all response surfaces.
Contributor Profiles — GitHub/Slack identity linking, expertise inference with decay scoring, and 4-tier adaptive review depth.
Review Pattern Clustering — HDBSCAN + UMAP theme detection injected as footnotes in PR reviews.
Per-repo behavior is controlled by .kodiai.yml — review strictness, model overrides, write-mode rules, and more.
See docs/configuration.md for the complete reference.
For environment variables and application-level settings, see .env.example.
# Run tests (discovery configured in bunfig.toml, scans src/)
bun test
# Type check
bunx tsc --noEmitFull documentation lives in the docs/ directory:
- Documentation Index — Start here for architecture, configuration, runbooks, and operational guides
- Architecture — System design, components, data flow
- Configuration —
.kodiai.ymlreference and environment variables
Kodiai deploys to Azure Container Apps via ACR remote build with zero-downtime rolling deploys.
See docs/deployment.md for details. For diagnosing review-request issues, see docs/runbooks/review-requested-debug.md.
See CONTRIBUTING.md for development workflow, coding standards, and how to submit changes.
Proprietary. All rights reserved.