Documentation
Get started

Open your first pull request

Turn an accepted, executable recommendation into a reviewable GitHub draft PR.

7 min read

Requirements

  • A recommendation with executable migration SQL.
  • GitHub sign-in and permission to install the dbtempo GitHub App.
  • A connected, indexed repository.
  • Source analysis and manual PR rollout flags enabled in the dbtempo environment.

Connect GitHub

  1. Install the app. Go to Source Code → Connect GitHub and install the dbtempo GitHub App for the required account or organization.
  2. Attach a repository. Select the repository and wait for indexing to finish. Confirm the detected framework and branch before continuing.

Open the PR

  1. Review the recommendation. Check the proposed fix, confidence, fix zone, source location, and any available before or after EXPLAIN evidence.
  2. Check that Open PR is enabled. Open PR requires a connected repository, a GitHub sign-in, and executable migration SQL — when it is disabled, its tooltip names what is missing.
  3. Choose the repository. If more than one repository is connected, select the target before opening the PR.
  4. Open the draft. Select Open PR, or approve the in-chat confirmation card. The confirmation card may offer Always allow for this repo for later eligible PRs.
A draft pull request confirmation listing the repository and changed file
The confirmation card shows the target and changed files before opening the draft.

Review the draft

The draft PR includes generated code changes, a changed-files list, advisory migration SQL when available, and risk notes. The full execution-plan evidence and source location remain on the recommendation detail page.

Track CI and merge status from the PR card or Source Code. dbtempo opens a draft; it does not merge the PR for you.