Skip to main content

Reach a GitHub organization's repositories

Your tasks reach GitHub with the account you connected on your profile. Connecting it is not always enough: a GitHub organization can keep Jaah out of its repositories until one of its owners lets Jaah in. When that happens for a project you work on, a warning under your Git accounts names the organization and gives you the link that fixes it.

Who can do this: every member, for their own GitHub account. Installing the Jaah GitHub App, or approving Jaah, takes an owner of the GitHub organization; anyone else can ask for it.

The Git tab: a connected GitHub account with its ⋯ menu and the + button

  1. Select your initials at the bottom of the sidebar, then My Profile.

  2. Select Git. Check your GitHub row has a green tick. If it reads Needs reconnect, fix that first: see Connect your GitHub, GitLab or other code host.

  3. Read the warnings under the list. Each one names the organizations it is about and ends in a link:

    WarningWhat to select
    hasn't installed the Jaah GitHub AppInstall or request approval
    The Jaah GitHub App isn't installed anywhere you can reach.Install or request approval
    hasn't approved JaahRequest approval
    uses single sign-onAuthorize
  4. Select the link. GitHub opens in a new tab.

  5. On GitHub, finish the step:

    • Install or request approval: pick the organization. If you own it, install the App on the repositories your projects use. If you don't, send the request to its owners.
    • Request approval: ask the organization's owners to approve Jaah.
    • Authorize: authorize Jaah for that organization with your single sign-on.
  6. Come back to Jaah and open the Git section again. Jaah checks every time the section opens, so the warning for that organization is gone once GitHub lets Jaah in.

  7. If you sent a request, the warning stays until an owner says yes. After a request made while connecting, a banner says Jaah is waiting for an organization owner to approve the GitHub App.

The row's menu: Reconnect and Disconnect

If you joined a new GitHub organization after connecting, open the GitHub row's ⋯ menu and select Reconnect, so Jaah learns what your account reaches now.

When an owner can't approve Jaah soon, paste a token instead: in the Git section select +, pick GitHub and Paste a token, and use a token that reaches the organization. A warning doesn't stop you creating tasks; it stops tasks you start on that organization's repositories from cloning or pushing.