Skip to main content

GitHub Configuration

Generate a Personal Access Token for GitHub and configure it in RoostGPT.

GitHub Cloud (github.com)

Quick Token Generation

Use this direct link to generate a token with all required scopes pre-selected:

Generate GitHub token →

Manual Steps

  1. Go to GitHub → Settings → Developer settings → Personal access tokens

    GitHub Settings

    Developer Settings

  2. Click "Generate new token""Generate new token (classic)"

  3. Set a descriptive name (e.g., RoostGPT) and an expiration

  4. Select the required scopes (see below)

  5. Click "Generate token"

  6. Copy the token immediately — it is shown only once

Required Scopes

ScopePurpose
repoFull repository access (read/write to code, issues, PRs)
admin:repo_hookRepository webhook management
notificationsAccess notifications
userUpdate user data

GitHub Enterprise Server

  • Token Type: Personal Access Token
  • Generation Steps: Same as GitHub Cloud but on your enterprise instance URL
  • Base URL: Configure your enterprise server URL (e.g., https://github.yourcompany.com)

Add to RoostGPT

Web UI (Connector)

  1. Click Connectors in the top navigation bar → Code Repositories
  2. Select GitHub
  3. Enter your Personal Access Token
  4. For Enterprise, also enter your Base URL

CLI (.env file)

GIT_TYPE=github
SOURCE_GIT_TOKEN=ghp_...your_token...
SOURCE_OWNER_NAME=your-org-or-username
SOURCE_REPO_NAME=your-repo
SOURCE_BASE_BRANCH=main

# For Enterprise (self-hosted):
HOSTED_TYPE=hosted
GIT_HOSTED_URL=https://github.yourcompany.com