This is a close to exhaustive list of Kodiak's features.
As always, feel free to email us at firstname.lastname@example.org with any question or concern.
Kodiak acts like a GitHub user. Any feature that works for a GitHub user likely works for Kodiak. Give it a go!
GitHub Branch Protection
Kodiak's behavior is largely driven by GitHub Branch Protection. If a PR is blocked from merging by a missing required status check, missing approval, merge conflict, etc., Kodiak will not merge the PR.
Updating Pull Requests
To have Kodiak update branches you must enable the "Require branches to be up to date before merging" GitHub Branch Protection setting.
When merging a pull request, Kodiak will update the PR if out of date with the target branch.
To have Kodiak immediately update any PR that is out-of-date, enable
Merging Pull Requests
When the automerge label (configurable via
merge.automerge_label) is applied to a pull request, Kodiak will merge the pull request if all GitHub Branch Protection requirements are met (status checks, reviews, etc.).
You can disable the
merge.automerge_label requirement by disabling
merge.require_automerge_label. This means that as soon as your pull request meets the GitHub Branch Protection requirements, Kodiak will merge the pull request.
Some required GitHub status checks may remain pending indefinitely. This is common for status checks that require manual approval or GitHub apps like the WIP GitHub App, which sets a pending status check until the PR title is updated.
To prevent these status checks from blocking Kodiak's merge queue you must add them to
Like the GitHub UI, Kodiak supports merging via "squash", "rebase", and "merge" commits. This is configurable via
Kodiak also supports the "Require signed commits" branch protection setting for "squash" and "merge" commit methods. The "rebase" method is not compatible due to GitHub API limitations.
The commit title and body of a comment can be customized with Kodiak via the
merge.message configuration options.
merge.message.body– use GitHub default body, the pull request body, or an empty string
merge.message.include_pr_number– include the pull request number in the title like GitHub does
merge.message.strip_html_comments– remove HTML comments from the pull request body. This is good for removing pull request templates
merge.message.include_pull_request_url– include the pull request URL at the bottom of the commit message
With GitHub Branch Protection, required status checks will prevent a pull request from merging until tests have passed. Draft pull requests will also prevent a pull request from merging.
Kodiak has some internal features to disable merging as well:
merge.blocking_title_regex– disable Kodiak merging based on a regex matching to the pull request title
merge.blocking_labels– disable Kodiak merging based on labels applied to the PR
merge.do_not_merge– completely disable Kodiak from merging any PR. This is useful if you only want to use Kodiak for updating pull requests.
With default settings, Kodiak will conserve continuous integration (CI) resources and only update a PR when necessary prior to merge. This can be altered with
update.always at a cost of more CI load.
By default Kodiak's internal merge queue acts on a first-come, first-served basis. The first pull request that enters the queue will be merge before any other pull request, even if another pull request requires fewer branch updates.
merge.prioritize_ready_to_merge is enabled and a PR is able to be merged without any branch updates, then Kodiak will merge the PR ignoring any pull requests in the queue.
If a pull request is out of date when Kodiak starts the merge process, Kodiak will not wait for pending status checks to finish before updating the pull request. This improves merge performance at the cost of potential extra CI jobs. You can disable this behavior by turning off
Kodiak can delete branches on merge when
merge.delete_branch_on_merge is enabled. GitHub now has this feature, but Kodiak had it first! 😊
By default, if a pull request encounters a merge conflict with the
merge.automerge_label applied, Kodiak will comment on the PR about the merge conflict and remove the automerge label. This can be turned off by disabling
Approving Pull Requests
Kodiak can approve PRs with
This is useful when the "Require pull request reviews before merging" Branch Protection setting is enabled and you want to automate dependency updates for services like dependabot.
If dependabot opens a PR, Kodiak can automatically approve the PR so it passes GitHub Branch Protection settings.
See Automated dependency updates with Dependabot for more information.