← Back

GitHub Connection Setup

Finding Your GitHub Personal Access Token (Classic)

To connect Toolstream to your GitHub repository, you need to create a Personal Access Token (classic) with the correct permissions.

Steps:

1. Navigate to GitHub Settings:

   • Log in to your GitHub account.
   • Click on your profile picture in the top-right corner, then click Settings.
   • In the left sidebar, scroll down and click Developer settings.
   • In the left sidebar, click Personal access tokens, then select Tokens (classic).
   • Alternatively, you can go directly to the page: https://github.com/settings/tokens

2. Generate a New Token:

   • Click the Generate new token button, and select Generate new token (classic).
   • Give your token a descriptive Note, for example, toolstream-dev-access.
   • Set the Expiration for the token. For better security, avoid "No expiration".

3. Select Scopes:

   • In the "Select scopes" section, you must check the box for repo. This grants full control of private repositories, which is necessary for the tool to read files, create issues, and manage pull requests.

4. Generate and Copy the Token:

   • Click the Generate token button at the bottom of the page.
   • This is the only time you will see the token. Copy it immediately.
   • Paste this token into the "GitHub Personal Access Token" field in your Toolstream connection settings.

---

Required Fields:

• Repository Owner: The username or organization name that owns the repository (e.g., in github.com/owner/repo, this is owner).
• Repository Name: The name of the repository itself (e.g., repo).
• GitHub Personal Access Token: The ghp_... token you just generated.