> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bondata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Connect BonData to GitHub for repository data

GitHub is the world's largest code hosting and collaboration platform, used by developers to manage repositories, track issues, and automate workflows. With BonData, you can connect to your GitHub repositories to read and analyze code, issue, and contributor data within Agent workflows.

## GitHub Personal Access Token Setup

Follow these steps to create a Personal Access Token for BonData.

### Step 1: Create a Personal Access Token

1. Go to [GitHub Settings → Developer Settings → Personal Access Tokens](https://github.com/settings/tokens)
2. Click **Generate new token** → **Generate new token (classic)**
3. Enter a note (e.g., `BonData Integration`)
4. Select an expiration (or no expiration)
5. Select scopes:
   * `repo` - Full control of private repositories
   * `read:user` - Read user profile data
6. Click **Generate token**
7. **Copy the token** - it starts with `ghp_` and won't be shown again

### Step 2: Identify Your Repository

Find the owner and repository name from your GitHub URL:

* URL: `https://github.com/mycompany/myrepo`
* Owner: `mycompany`
* Repository: `myrepo`

### Step 3: Enter Credentials

Enter your Personal Access Token, owner, and repository name in BonData.

## Required Fields

| Field                 | Description                                                                  |
| --------------------- | ---------------------------------------------------------------------------- |
| Personal Access Token | Generated from GitHub Settings → Developer settings → Personal access tokens |
| Owner                 | The username or organization that owns the repository                        |
| Repository            | The name of the repository to connect to                                     |