Having issues selecting a repository owner?

If you don’t see your desired owner in the list of owners in the Graphite onboarding flow and know that the Graphite GitHub App isn’t installed on the owning account, you should follow the instructions underneath the list of owners starting with Don't see what you're looking for above?. If you know that the Graphite GitHub App is installed on your organization, you should click the Authenticate Graphite App button. If you’re a collaborator on a personal repository that you’d like to use with Graphite, you must install the Graphite GitHub App on your personal account. If you’re still unable to select your desired repository owner, contact us at support@graphite.dev.

Don’t see the repository you’re looking for?

You can choose which repositories within your organization you want the Graphite GitHub App to have access to. If you don’t see a certain repo in the repository selector in the Graphite Web App, it’s likely that you haven’t granted the Graphite GitHub App access to those repositories. You can do so in the GitHub App settings within your organization. (The URL will look like this: https://github.com/{orgname}/settings/installations) If you’re using a Personal Access Token to onboard with Graphite and you don’t see repositories for that organization, there are two possibilities:
  1. Your organization may use SAML SSO, so you must authorize the token after it’s been created for it to have access to that organization’s resources. See GitHub’s instructions.
  2. The organization has restricted access to resources for classic PATs. See more about this on GitHub’s documentation, and you can reach out to an organization owner to find out if they can lift this restriction.
If you’re a collaborator on a private personal repository, then the owner of the repository must also install the Graphite GitHub application on their personal account in order to select the repository in Graphite. You can also authenticate with a Personal Access Token to see private repositories, but installing the Graphite GitHub App is recommended.

Why is Graphite asking to act on my behalf?

You have arrived at this step because:
  1. The Graphite App is installed on your organization but you don’t see it in the organizations list
  2. You clicked Add organization from GitHub and the organization had the word Configure next to it in this list (indicating that the app is already installed on the organization)
This primarily treats the case where a new user is onboarding with Graphite and wants to join an organization that already has the Graphite App installed. Once you click this button, you will see a confirmation modal saying that we will redirect you to GitHub to authorize the Graphite App along with a special note that if you do so, the Graphite App will only have access to the organizations on which it’s installed.
This button only appears if you haven’t already authenticated the Graphite App. Once you do so, you will return to the organization selection screen and see your desired organization.

Why are all my GitHub organization’s repositories saying Missing permissions in Graphite UI, or gt CLI saying I need to join a team?

You may have been removed from the GitHub organization. Check this with the organization’s GitHub administrators. If you have not been removed and the organization uses SAML SSO authentication, ensure that your GitHub user account also has an active SAML session with your organization.