Kubiya LogoKubiya Developer Docs
Integrations

Connect to GitHub

Integrate Kubiya with GitHub using OAuth and the Kubiya GitHub App.

Connect to GitHub

Integrate Kubiya with GitHub to allow agents to interact with your repositories, issues, and other GitHub resources.

Prerequisites

  • Access to a GitHub account.
  • For organization-level access: Permission to install or request installation of the Kubiya GitHub App on your organization.

How it Works

Kubiya uses a combination of a GitHub App installation (for organization/repository access) and individual user OAuth authorization.

When an agent interacts with GitHub on behalf of an authenticated user, Kubiya provides a temporary OAuth2 token specific to that user to the agent's execution environment as the GH_TOKEN environment variable. Tools (like the official GitHub CLI or custom scripts) can use this token to authenticate requests.

Enabling the Integration

You can enable the GitHub integration through the Kubiya Web UI or directly from Slack.

From the Web Interface

  1. Log in to the Kubiya Platform.
  2. Navigate to the Integrations section. [Image: Kubiya Integrations List]
  3. Click the + New Integration button. [Image: Kubiya Integrations List - New Integration Button]
  4. Locate the GitHub integration and click Add. [Image: Kubiya New Integration Modal - GitHub]
  5. Follow the prompts:
    • Install GitHub App: Click this to install the Kubiya GitHub App on your desired organization or personal account. You will be redirected to GitHub to select repositories and grant permissions.
    • Authorize with GitHub: Click this to link your personal GitHub account via OAuth. This allows agents to act as you when you interact with them. You will be redirected to GitHub to authorize. [Image: Kubiya GitHub Integration Config - Install/Authorize Buttons]

Each user who wants agents to interact with GitHub on their behalf (even when interacting via Slack/Teams) must complete the "Authorize with GitHub" step. This ensures actions are performed with the correct user permissions.

Once both steps are completed (App installed and user authorized), the integration is active.

From the Slack App

  1. Use the /manage slash command in Slack to open the management interface. [Image: Slack /manage command example]
  2. Click the Connect with GitHub... button.
  3. Click Authorize GitHub. [Image: Slack Kubiya Management - Authorize GitHub]
  4. You will be redirected to GitHub to authorize your account.

After authorization, any agent utilizing the GitHub integration will use your credentials when you interact with it via Slack. The GH_TOKEN environment variable will be available to tools executed by the agent.

On this page