kendo.dev

Appearance

GitHub App ​

The kendo GitHub App is a per-workspace install that lets kendo receive webhooks from your repositories, update pull request status, and link branches to issues automatically.

It's a separate thing from the per-user OAuth connection used for branch creation — see OAuth vs App below.

OAuth vs App ​

ThingPer-user OAuthPer-workspace GitHub App
Who installs itEach developer from their profileA workspace admin, once
What it enablesCreating branches from an issue, reading repos on your behalfWebhooks, PR check runs, automated lane transitions
Where you find itProfile → Connect GitHubSettings → GitHub App
ScopeYour GitHub accountOne GitHub org (or personal account)

Both are useful. Most teams will install the GitHub App on their org; individual developers separately connect their OAuth account for branch creation.

When you need it ​

Install the GitHub App if your team wants any of:

  • PR status updates on issues
  • Branch auto-linking when a branch matching an issue key is pushed
  • Lane GitHub triggers (e.g. "move to Review when PR opens")
  • Commit-check annotations on the PR

If you only use kendo for manual tracking, you don't need it.

Prerequisites ​

  • You're a workspace admin on the kendo tenant
  • You can install GitHub Apps on the target GitHub org (or you're installing into your personal GitHub account)

How to install ​

  1. Sign in to kendo and open Settings → GitHub App.
  2. Click Install GitHub App. A popup opens to github.com.
  3. Pick the GitHub account or organization you want to install into.
  4. Choose All repositories or pick specific ones.
  5. Click Install. The popup closes and kendo shows "Installed" with the account login.

That's it — webhooks start flowing immediately.

What it enables ​

Once installed, the branch-linking, PR-tracking, webhook, and lane-trigger features described in the main GitHub Integration page start working for your repositories.

How to uninstall ​

Uninstalling is a two-step flow:

  1. In kendo: open Settings → GitHub App and click Disconnect. This unlinks the installation from your kendo workspace — kendo stops receiving webhooks for your repos.
  2. On GitHub (optional): the App is still installed on your org. To remove it entirely, go to:

The two steps are independent — you can do either first.

Troubleshooting ​

"Please allow popups and try again" — Your browser blocked the install popup. Allow popups for kendo and click Install again.

Installation completed on GitHub, but kendo still shows "Not Installed" — Refresh the page. If it still doesn't show, try the install flow once more; the first attempt's webhook may have arrived before the page was ready.

Org approval required — GitHub may require an org owner to approve the install. Ask an owner to visit the App's install page and approve.

"GitHub App is not configured for this environment" — The workspace's environment isn't set up for GitHub App installs. Contact your administrator.

See Also ​