Skip to content

Latest commit

 

History

1,296 Commits

Folders and files

Supercheck logo Supercheck

Open-source testing, monitoring, and AI SRE — as code.

Supercheck brings Playwright test automation, k6 performance testing, uptime and synthetic monitoring, incident investigation, and public status communication into one platform. Use the web application, manage resources from the CLI, and record browser tests with the Supercheck Recorder.

Website Documentation npm License

What Supercheck includes

  • Test automation: browser, API, database, custom, and k6 performance tests, with AI-assisted creation and failure analysis.
  • Monitoring: HTTP, website and SSL, ping, port, and scheduled synthetic browser checks.
  • Investigation: run logs, screenshots, traces, linked artifacts, and read-only AI SRE investigation over Supercheck evidence and configured connectors.
  • Communication: alerts through email, Slack, Discord, Telegram, Microsoft Teams, and webhooks, plus public status pages and subscriber notifications.
  • Governance: organizations, projects, six RBAC roles, API keys, audit trails, requirements traceability, and coverage snapshots.
  • Secure execution: isolated execution environments, network restrictions, and resource limits for Playwright and k6 workloads.

Competitive landscape

Supercheck combines capabilities that are commonly split across test automation, synthetic monitoring, load testing, status communication, and incident-investigation products. The comparison below describes each product's primary, natively documented scope; integrations or adjacent products may extend it.

Platform Primary focus Test automation Synthetic / uptime Load testing Status pages AI SRE
Supercheck Unified reliability ✅ ✅ ✅ ✅ ✅
Checkly Synthetic monitoring & testing ✅ ✅ — ✅ Partial
Datadog Observability & synthetics Partial ✅ — Partial Partial
Better Stack Observability & incident management Partial ✅ — ✅ Partial
UptimeRobot Uptime monitoring — ✅ — ✅ —
BrowserStack Browser & device cloud ✅ — ✅ — Partial
Sauce Labs Browser & device cloud ✅ Partial — — Partial
Cypress Cloud Cypress orchestration ✅ — — — Partial
Grafana k6 Performance & load testing — Partial ✅ — Partial
Azure Cloud test execution ✅ — ✅ — —
Statuspage Status communication — — — ✅ —
Instatus Status pages & uptime — ✅ — ✅ Partial
HolmesGPT AI SRE investigation — Partial — — ✅
PagerDuty Event intelligence & response — — — — ✅
Resolve AI AI production ops — — — — ✅

* Comparison snapshot: October 2026. Product capabilities may change. "Partial" means available through a separate product or plan, or with limited scope. The pricing page compares costs for Checkly, Datadog, Better Stack and BrowserStack.

Get started

Self-host Supercheck

Follow the self-hosting guide to install Supercheck on a Linux server and configure HTTPS, optional integrations, backups, and worker scaling.

Install the CLI

The CLI requires Node.js 20 or later.

npm install -g @supercheck/cli
supercheck init

Create a token under Organization → CLI Tokens, then authenticate:

supercheck login --token sck_live_...
supercheck pull
supercheck diff
supercheck deploy

Manual AI SRE triage and investigations are enabled by default with a configured AI provider. Automatic AI work and live connector access remain opt-in. On-call engineers can use the incident number shown by incident list or its UUID:

supercheck incident list
supercheck sre triage <incident-number-or-uuid>
supercheck sre investigate <incident-number-or-uuid> --live-connectors
supercheck sre ask "Summarize the strongest evidence" --incident <incident-number-or-uuid>

See the CLI guide and command reference for resource management, local execution, and CI/CD usage.

Install the recorder

Record browser interactions as Playwright code and send them to the Supercheck Playground:

Architecture

flowchart TB
    Users[Users / CI/CD] --> T[Traefik Proxy<br/>SSL / Load Balancer]
    T --> App[Next.js App<br/>UI + API]
    App --> DB[(PostgreSQL<br/>Primary DB)] & Redis[(Redis + BullMQ<br/>Queue + Cache)] & S3[(RustFS<br/>Artifacts)]
    App --> SRE[AI SRE Engine<br/>Read-only investigations]
    SRE -.-> Private[Private Agents<br/>Outbound-only queries]

    Redis --> Workers[Workers<br/>NestJS + BullMQ]
    Workers --> Sandbox[Isolated Test<br/>Execution Sandboxes]

    style Users fill:#6366f1,stroke:#4338ca,color:#fff
    style T fill:#0ea5e9,stroke:#0369a1,color:#fff
    style App fill:#3b82f6,stroke:#1e40af,color:#fff
    style DB fill:#f59e0b,stroke:#b45309,color:#fff
    style Redis fill:#ef4444,stroke:#b91c1c,color:#fff
    style S3 fill:#8b5cf6,stroke:#6d28d9,color:#fff
    style SRE fill:#0ea5e9,stroke:#0369a1,color:#fff
    style Private fill:#8b5cf6,stroke:#6d28d9,color:#fff
    style Workers fill:#10b981,stroke:#047857,color:#fff
    style Sandbox fill:#059669,stroke:#047857,color:#fff
Loading

The application stores platform data in PostgreSQL, schedules work through Redis and BullMQ, and keeps execution artifacts in S3-compatible storage (RustFS in the bundled stack). Workers consume execution queues and run Playwright or k6 workloads in isolated execution environments. Increase WORKER_REPLICAS and set RUNNING_CAPACITY to the same value to increase execution capacity.

Repository layout

Path Purpose License
app/ Next.js web application and API AGPL-3.0-only
worker/ NestJS orchestration and execution worker AGPL-3.0-only
cli/ @supercheck/cli source and documentation Apache-2.0
recorder/ Browser recorder based on Playwright CRX Apache-2.0
docs/ Product and deployment documentation AGPL-3.0-only
deploy/ Docker Compose deployment assets AGPL-3.0-only

Documentation

Contributing and security

Contributions are welcome. Before opening a pull request, read CONTRIBUTING.md and follow the Code of Conduct. Governance and release expectations are described in GOVERNANCE.md, help is listed in SUPPORT.md, and release history is in CHANGELOG.md.

Use the issue chooser for reproducible bugs, documentation fixes, and feature requests, and GitHub Discussions for proposals and questions.

Please report vulnerabilities privately as described in SECURITY.md.

Community integrations

Integration Description
Azure DevOps Community-maintained pipeline tasks and dashboard widget

Community integrations are maintained outside the core Supercheck repository. If you have built one, open a Discussion to share it.

License

The Supercheck app, worker (including Private Agent mode), documentation, and deployment assets are licensed under AGPL-3.0-only. The CLI, from version 0.3.1, and recorder are Apache-2.0. Third-party licenses and notices remain in effect; earlier releases retain their original terms.

The Supercheck name and logo are covered by the trademark policy.

Community

GitHub Issues GitHub Discussions