Linking Your GitHub Repository to SeeR: Step-by-Step Guide 🔗

This guide walks you through how to securely link your GitHub repository with SeeR, enable continuous monitoring, and automate test execution.

---

🔐 Step 1: Generate a GitHub Personal Access Token (PAT)

To let SeeR securely connect to your repository:

1. Go to GitHub: Navigate to Settings > Developer Settings > Personal Access Tokens > Tokens (classic)

2. Click "Generate new token (classic)"

3. Add a name like SeeR-integration

4. Set expiration (optional or choose "No expiration")

5. Select required scopes:

   • repo ✔️ (Full control of private repos)

   • workflow ✔️ (Read/write GitHub Actions workflows)

   • admin:repo_hook ✔️ (Control webhooks)

   • read:org ✔️ (Read organization-level metadata)

6. Click "Generate token" and copy it immediately (GitHub won't show it again)

GitHub Token Scope

---

🧾 Step 2: Fill in GitHub Details in SeeR

In SeeR, during Step 5 (Link Repository):

1. Paste your GitHub token into the GitHub Access Token field

2. Enter your repo URL, e.g., https://github.com/username/repository

3. Branch: e.g., main

4. Folder to Monitor: e.g., src

5. Select a Development Framework from the dropdown

6. Click "Connect Repository"

SeeR GitHub Repo Setup

---

🚀 Step 3: Configure GitHub Workflow for Code Impact Monitoring

To enable GitHub → SeeR continuous test triggering, create a GitHub Actions workflow.

1. In your repository, go to: .github/workflows/

2. Add a new file named: .github/workflows/code-impact.yml

Paste the content it shows on UI.

---

🔑 Step 4: Set GitHub Secrets for Workflow Authentication

In your GitHub repository:

1. Go to Settings > Secrets > Actions

2. Click “New repository secret”

3. Create the following secrets with these values:

Secret Name	Value
IMPACT_API_URL	https://stg-gateway.qyrus.com:8243/impact-dispatcher/v1
API_ACCESS_TOKEN	Bearer 90540897-748a-3ef2-b3a3-c6f8f42022da
GITHUB_TOKEN	Your GitHub Personal Access Token (generated in Step 1)
PROJECT_ID	Go to SeeR > click the ... next to the Agent name > Copy Job ID

📌 Note:

• IMPACT_API_URL points to the Python Impact Analyzer service.

• API_ACCESS_TOKEN is your authentication token for the gateway.

• PROJECT_ID links the workflow to the correct agent inside SeeR.

These secrets enable GitHub Actions to securely trigger SeeR’s impact analysis.

✅ Done! SeeR is Now Linked to GitHub

• Automated tests will now trigger with every commit.

• You’ll see reports and results directly in the SeeR dashboard.

➡️ Return to Configuration Guide

---