Zentrik

Zentrik + GitHub

Bring delivery movement into product context by installing the Zentrik GitHub App and showing active pull requests, branches, checks, and recently merged work where product teams already plan.

Zentrik connects to GitHub with a GitHub App installation. The connection is read-oriented: Zentrik reads selected repository metadata, pull requests, branches, commits, and commit status so Home and Settings can show work as it enters development and becomes complete.

Zentrik stores the installation identity and repository metadata. Runtime GitHub reads use short-lived installation tokens generated server-side.

Connect GitHub

Workspace admins connect GitHub from Settings -> Integrations -> GitHub.

Install GitHub App

  1. Open Settings -> Integrations -> GitHub.
  2. Choose Connect GitHub.
  3. GitHub opens the Zentrik GitHub App installation flow.
  4. Choose the organization or account.
  5. Select the repositories Zentrik should read.
  6. Choose Install & Authorize.
  7. GitHub redirects back to /oauth-callback-github and Zentrik starts checking the selected repositories.

Select repositories

Select repositories in GitHub during installation. Zentrik can summarize the installed repositories immediately after callback.

If a workspace should focus on one installed repository, use the repository focus fields on the GitHub integration detail page. Zentrik verifies that the installation can read that repository before saving the focus.

How to use it

After repositories are selected, Zentrik shows GitHub delivery status in Home and on the GitHub integration detail page.

Development status

The development status view shows:

  • Open, draft, and recently merged pull requests
  • Active non-default branches
  • Branches that do not yet have a pull request
  • Commit status/check state when GitHub exposes it through the REST API

Use this view to see whether scoped product work is still in branch form, under review, or merged.

For workspace admins

  • Reconnect GitHub if the GitHub App is uninstalled, repository permissions change, or selected repositories need to change.
  • Update the focused repository from the integration detail page when the workspace should follow one installed repository.
  • Keep the GitHub App permissions read-only: metadata, contents, pull requests, commit statuses, and checks.

Troubleshooting

Most connection problems clear up after a fresh authorization or an admin allows the app. If you have tried that and still cannot connect, contact us and we will help.

Installation succeeds but repository focus fails

Confirm that repository is included in the GitHub App installation. Organization owners can update the selected repositories from GitHub.

Home does not show GitHub status

Open Settings -> Integrations -> GitHub and confirm the GitHub App installation includes at least one repository.

Still stuck

Contact us and we will help troubleshoot the workspace connection with you.