Welcome to AegisRunner Documentation
Learn how to use AegisRunner for automated regression testing. Browse our guides and tutorials to get started.
Getting Started
Quick start guides and initial setup
Crawling
Website crawling and page discovery
Test Generation
AI-powered test creation
Test Execution
Running and monitoring tests
Scheduling
Automated test scheduling
Integrations
CI/CD and third-party integrations
All Articles
What is AegisRunner?
Automated regression testing for web apps. Scan your site, generate Playwright tests, run on Chromium/Firefox/WebKit, auto-heal when locators drift.
Common Issues
Troubleshooting by area: sign-in, scans, AI tests, runs, visual regression, notifications, billing, CI/API, performance.
API Overview
REST API for triggering scans/runs and managing your account. Auth, endpoints, pagination, rate limits, idempotency.
Subscription Plans
Five plans, billed via Paddle. Tax handled globally — VAT, GST, sales tax. Razorpay removed April 2026; Paddle is sole merchant of record now.
Team Management
Invite teammates, manage roles, track invitations, bulk operations on Pro+, domain auto-join, SSO JIT.
CI/CD Integration
Trigger scans and runs from any CI. Token setup, full payload, GitHub PR sticky comments, commit status checks, smart test selection.
Scheduling Automated Tests
Schedule test suites on cron. Plan limits (Starter weekly, Pro+ unlimited), overlap handling, baseline replay scheduling, notification routing.
Running Tests
Run test suites across Chromium, Firefox, and WebKit. Live results, auto-heal, AI triage, single-test re-runs, and CI triggering.
AI-Powered Test Generation
How AegisRunner writes tests for every scanned page: the three-pass pipeline, scenario families, plan-aware coverage, custom prompts, and BYOK.
Starting a New Crawl
Configure and start a new scan. Modes, page scope, device emulation, fill/submit forms, audits, plan limits, baselines, and CI triggering.
Quick Start Guide
First project scanned and first tests running in about five minutes. Covers free scan, auto-scan on project creation, multi-browser runs, and self-healing tests.
Roles & Permissions (RBAC)
Owner / Admin / Member / Viewer at organization and project layers. Full permission matrix, invitation states, seat limits, audit logs.
Free Scan
Try AegisRunner with no signup. Drop in a URL and email, get a one-page scan and AI-generated tests by email in about 90 seconds.
Debugging Failed Tests
Auto-heal first, AI triage second. Then screenshots, logs, traces. Plus common failure modes — locators, timeouts, auth, flakes, bot-block — and how to fix each.
Usage & Billing
Day-to-day billing: usage counters, plan changes, Paddle invoices, tax IDs, currency display.
Slack Integration
Slack Incoming Webhook setup, multi-channel routing on Pro+, mentions, reactions, slash commands.
Creating User Flow Tests
Multi-page tests that simulate real journeys. Mix UI and API steps; capture values across steps; use {{RANDOM}} for unique data.
Understanding Crawl Results
Read scan results: pages, states, accessibility, SEO, security, performance, AI test coverage banner, baselines, and comparisons.
Dashboard Overview
How the dashboard works: per-project vs workspace mode, stats, quick actions, the getting-started checklist, coverage gaps, and recent activity.
SSO / SAML Single Sign-On
SAML SSO with Okta, Entra, Google Workspace. JIT provisioning, group-to-role mappings on Enterprise, enforcement.
Live Demos
Public scans of well-known production sites — Stripe, Tailwind, React, Next.js, Astro, Svelte, Nuxt — with the AI-generated test suites and downloadable Playwright code.
POM Export
Export any suite as a structured Playwright project with Page Object Model architecture. Drop into your repo and run.
Visual Regression Testing
Pixel-level screenshot diffs at every test step. 3-panel diff UI, accept/reject, masking, plan-based retention.
Integrations Guide
Index of all integrations: notifications, CI, deployment hooks, SSO, BYOK, test data, audit logs.
Composite Test Suites
Combine multiple test suites into one. Share browser session across children for stateful flows. Run policy controls failure behavior.
Account Settings
Personal profile, security (password / 2FA / sessions), email preferences, API tokens, account deletion.
Test Data Management
Manage tokens, cookies, headers, and login scripts per project / environment. AES-256 at rest, masked in logs.
Notifications & Alerts
Email, Slack, Discord, Teams, webhooks. Per-channel event filters so engineering doesn't see the QA noise. HMAC-signed webhooks.
API Testing
Mix HTTP API steps with UI steps in any test. JSON-path assertions, value capture, GraphQL, auth patterns.
Managing Projects
Create projects, switch between the eight tabs, configure tokens and login scripts, set up environments, manage team roles, and delete safely.
Deployment Webhooks
Auto-trigger scans on every deploy. Vercel, Netlify, GitLab, or a signed generic webhook. Works with preview URLs and pairs with PR comments.
Two-Factor Authentication (2FA)
TOTP 2FA via any authenticator app. Backup codes, recovery flow, organization-wide enforcement on Business+.
Test Baseline Review
Review AI-generated tests before they run unattended. Approve, edit, or reject; strict mode for compliance.
Issue Tracking (Jira & GitHub)
Auto-file GitHub Issues or Jira tickets per failure cluster. Updates and de-duplicates across runs. Auto-resolves when failures clear.
Failure Triage
Automatic cluster + label of every failure: real regression, new failure, flake, environment, or auto-healed — with concrete fix suggestions.
Smart Test Selection
Run only the tests that matter on this PR. Strategies: changed files, flake, recency, tags, last-run failures.
Accessibility Testing
axe-core WCAG checks on every page. Severity-ranked findings, ARIA snapshots, ruleset config, and compliance report exports.
Regression Manifests
Deterministic CI: capture one good scan as a manifest and replay the exact same path every time. Pair with visual regression for pixel-level checks.
Need help?
Can't find what you're looking for? Our support team is here to help.