Connect to GitHub

Prerequisites

Before you begin, ensure that you have the following:

• Access to a GitHub account

• For organization access: Kubiya GitHub App installed on your GitHub organization

How it Works

An environment variable called GH_TOKEN (supported by the GitHub CLI interface) will be passed to the agent container environment automatically, allowing users to user GitHub from within the agent. The environment variable value will be based on the GitHub temporary OAuth2 token granted by Kubiya

Enabling the Integration

From the web interface

Integration Setup:

1. Log in to your Kubiya dashboard.

Enable GitHub:

2. Navigate to the "Integrations" panel.

Connect GitHub:

3. Click the "+ New Integration" button.

4. Locate the GitHub integration and click the "Add" button.

5. First connect your GitHub organization by installing the GitHub app with the "Install GitHub App" button. Then, activate your account by authorizing with GitHub with the "Authorize with GitHub" button. When clicking both of these buttons, you will be redirected to GitHub to authorize or install.

When conversing with agents, even on platforms like Slack, and want to use it with GitHub, you need to log in with GitHub's system (OAuth2). Each person has to do this separately, ensuring only they can use their specific login and permissions with Kubiya.

You can now chat with Kubiya about your GitHub resources.

From the Slack App

Using the /manage slash command.

1. Use the /manage slash command to enter the management interface:

   
2. Click on "Connect with GitHub.."

3. Click on "Authorize Github":

   

4. You will be redirected to GitHub to authorize your account.

5. Start any agent with GitHub integration enabled to use your credentials. The GitHub OAuth2 token will be passed to the container environment automatically - named: GH_TOKEN (matches with GitHub CLI)