Integrations Guide

AegisRunner integrates with your favorite development tools to streamline your testing workflow. Available on Pro and Business plans.

Available Integrations

Discord Integration

Receive test results and failure alerts directly in your Discord server.

Jira Integration

Automatically create Jira issues when tests fail, keeping your bug tracking in sync.

Setup

Configuration Options

GitHub Integration

Post test results as PR comments and set commit status checks on your GitHub repository.

Setup

What Gets Posted

• PR Comments: A summary of test results (passed/failed/skipped) is posted as a comment on pull requests
• Commit Status: A pass/fail status check appears on commits, blocking merges if tests fail

Vercel Integration

Automatically test your Vercel preview deployments when they go live.

Setup

1. Go to your project → Integrations → Vercel
2. Enable the integration
3. Enter your Vercel access token (generate at vercel.com/account/tokens)
4. Enter your Team ID (optional) and Vercel Project ID
5. Enable Auto-test preview deployments
6. Copy the webhook URL shown and add it to your Vercel project's webhook settings
7. Click Save Vercel Settings

Netlify Integration

Automatically test your Netlify deploy previews.

Setup

1. Go to your project → Integrations → Netlify
2. Enable the integration
3. Enter your Netlify personal access token (generate at app.netlify.com)
4. Enter your Site ID
5. Enable Auto-test deploy previews
6. Copy the webhook URL shown and add it as an outgoing webhook in Netlify under Deploy notifications
7. Click Save Netlify Settings

CI Crawl Pages

Configure specific pages to crawl during CI/CD runs instead of crawling your entire site. This speeds up CI pipelines by focusing on the pages that matter most.

How It Works

1. Go to your project → Integrations → CI Crawl
2. Enable CI crawl pages
3. Add page paths (e.g., /login, /dashboard, /pricing)
4. Optionally enable Auto-generate AI tests for crawled pages
5. Click Save CI Crawl Settings

Combining Pages

CI crawl pages can come from two sources that are automatically merged:

Example: CI Trigger with Pages

curl -X POST https://aegisrunner.com/api/v1/ci/trigger \
  -H "Authorization: Bearer aegis_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "crawlPages": ["/checkout", "/account"],
    "baseUrl": "https://preview-123.vercel.app",
    "generateTests": true
  }'

Visual Regression Testing

Visual regression testing is built into AegisRunner's test execution engine. Enable it when running tests to automatically compare screenshots against baselines.

• Pixel-level diffs using pixelmatch
• Three-panel view: baseline, current, and diff
• Baseline management: accept or reject visual changes
• Diff percentage scoring for each comparison

See Visual Regression Testing for setup and usage details.

API Testing

Test REST and GraphQL API endpoints alongside your UI tests using api-request steps.

• HTTP methods: GET, POST, PUT, DELETE
• Assertions: status codes, response bodies (JSON path), response times
• No browser overhead: API steps run via Node.js fetch directly
• Combined workflows: Mix UI and API steps in the same suite

See API Testing for setup and usage details.

Related Documentation

• CI/CD Integration - Set up CI tokens and trigger test runs
• Slack Integration - Slack webhook notifications
• Scheduling Tests - Automate test runs on a schedule
• Subscription Plans - Plan features and limits