# chdsbd/kodiak

🔮 A bot to automatically update and merge GitHub PRs

Repository: https://github.com/chdsbd/kodiak
Canonical: https://ross.abutalabs.com/products/kodiak
Homepage: https://kodiakhq.com
Language: Python
License: AGPL-3.0
License Family: copyleft
Topics: kodiak, bot, python, typescript, redis, pull-requests, prs
Last push: 2026-08-06T23:45:46+00:00

## Health v2 (maintenance only)
Score: 89/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 96, release rhythm 74, longevity 100
- inputs: {"age_days": 2694, "days_push": 27, "days_rel": 173, "gap_med": 0, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1109, forks 71 (observed 2026-08-28T04:03:37.263113+00:00)

## What it is
Kodiak is a GitHub bot that automatically updates and merges pull requests based on a .kodiak.toml configuration file. It keeps branches up to date with the target branch, merges PRs once CI and approvals pass, and works alongside dependency bots like Dependabot and Renovate.

## Use cases
- automatically merge github pull requests when ci passes
- keep pr branches up to date with master
- auto merge dependabot pull requests
- set up a merge queue for github pull requests
- automatically delete stale branches after merge
- reduce manual rebasing of pull requests
- automate dependency update merging with renovate

## When to choose
- your team wastes time manually updating branches to satisfy 'require branches up to date' branch protection
- you want dependency bot PRs merged automatically by upgrade type
- you want a hosted GitHub App or a self-hosted bot with TOML configuration

## When to avoid
- you use GitLab, Bitbucket, or another non-GitHub forge
- you need complex custom merge policies beyond Kodiak's configuration options
- you cannot grant a bot write access to pull requests and contents in your repositories

## Facets
- artifact type: service
- maturity: active
- function: workflow-automation, ci-cd, webhook, developer-tools
- domain: developer-tools, version-control
- platform: self-hosted, python
- tags: github-bot, automerge, merge-queue, pull-requests, dependabot, renovate, branch-updates, automation, devops, web-server, docker, nodejs

## Member repositories
- chdsbd/kodiak (main) score 89

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:37.263113+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:43:34.431363+00:00, confidence not recorded.
  - readme: https://github.com/chdsbd/kodiak (fetched 2026-08-28T04:03:37.263113+00:00, sha ee387146c3a5)
  - homepage: https://kodiakhq.com (fetched 2026-08-29T12:47:30.714622+00:00, sha 6666cb0dcaee)
  - site_page: https://kodiakhq.com/docs/quickstart (fetched 2026-08-29T12:47:30.717289+00:00, sha 6cbfb6d82bd7)
  - site_page: https://kodiakhq.com/docs/recipes (fetched 2026-08-29T12:47:30.719064+00:00, sha 5df4a4ae9f48)
  - site_page: https://kodiakhq.com/docs/why-and-how (fetched 2026-08-29T12:47:30.721020+00:00, sha 346f1985a5d0)
  - site_page: https://kodiakhq.com/docs/config-reference (fetched 2026-08-29T12:47:30.722748+00:00, sha fe26de9f49a8)
  - site_page: https://kodiakhq.com/docs/permissions (fetched 2026-08-29T12:47:30.725568+00:00, sha a1817b7e976e)
- Data as of 2026-08-30T08:39:29.467469+00:00.