OpenQAOpenQA
Integrations

GitHub Integration

Automatically run tests on merge and create issues for discovered bugs.

Features

Auto-Test on Merge

Run tests when PRs are merged to main

Issue Creation

Auto-create issues for discovered bugs

Setup

1. Create a Personal Access Token

Go to GitHub → Settings → Developer settings → Personal access tokens → Generate new token

Required scopes: repo, write:issues

2. Configure Environment

.env
1GITHUB_TOKEN=ghp_your_personal_access_token
2GITHUB_OWNER=your-username-or-org
3GITHUB_REPO=your-repository-name

3. Enable Git Listener

.env
1GIT_LISTENER_ENABLED=true
2GIT_LISTENER_POLL_INTERVAL=60000

How It Works

PR Merged to main
       ↓
OpenQA detects merge event
       ↓
Runs full test suite
       ↓
Bug found? → Creates GitHub Issue
       ↓
All tests pass? → ✅ Success notification

Auto-Created Issues

When OpenQA finds a bug, it creates a detailed GitHub issue:

GitHub Issue
1## 🐛 Bug: XSS vulnerability in search input
2 
3**Severity:** High
4**Test:** test_search_xss.spec.ts
5**Discovered:** 2024-01-15 10:30:00
6 
7### Description
8The search input does not sanitize user input, allowing XSS attacks.
9 
10### Steps to Reproduce
111. Go to /search
122. Enter: `<script>alert('XSS')</script>`
133. Submit the form
144. Script executes in browser
15 
16### Expected Behavior
17Input should be sanitized and script should not execute.
18 
19### Screenshot
20![Screenshot](https://openqa.example.com/screenshots/bug_001.png)
21 
22---
23*This issue was automatically created by OpenQA*

Next Steps