The BlackBat AI handbook
One page per task — practical, in order, and kept current as BlackBat AI ships. Read it start to finish or jump to what you need.
- 01
How to Run Your First Test with BlackBat AI
Point BlackBat AI at a URL and get a map of your app plus a list of what's broken — in about the time it takes to read this. No scripts, no setup, no config file.
4 min - 02
How to Read the Navigation Map
BlackBat AI's navigation map turns a run into a picture of your app: every page it reached, every flow between them, and the gaps where coverage stops. Here's how to read one and act on it.
3 min - 03
How to Generate a Test Suite from a Plain-English Prompt
Autonomous exploration finds the unexpected. When you already know which flows matter, describe them in a sentence and BlackBat AI turns them into a repeatable suite you can run on every release.
4 min - 04
How to Test a Staging or Private Environment with the BlackBat AI Runner
Your staging environment doesn't have to be public to be tested. Run the BlackBat AI Runner inside your own network and BlackBat AI tests it from there — nothing exposed.
2 min - 05
How to Review a Run: Bugs, Screenshots, and Reproduction Steps
A finished run gives you a bug list, a map, and a lot of context. Here's how to work through it fast — triage the findings, confirm the real ones, and hand them off.
2 min - 06
How Diff Runs Work
A diff run re-crawls only the pages that changed since your last run, so a routine re-check costs a fraction of a full crawl in time and credits — with the same navigation map and findings at the end.
2 min - 07
How to Organize Projects, Environments, and Your Team in BlackBat AI
A quick guide to structuring BlackBat AI for a real team: one project per app, environments for staging and production, and shared access so everyone sees the same runs and findings.
2 min - 08
How to Set Up Run Notifications in BlackBat AI
Get told when a run finishes or finds issues, so you're not refreshing the dashboard. A short guide to run notifications and how to keep them high-signal.
2 min - 09
How to Manage Credits and Billing in BlackBat AI
How BlackBat AI credits work, how to see what a run costs, what happens when you run low, and how to add capacity — a short, practical guide.
2 min - 10
How to Fit BlackBat AI Into Your Release Process
Where autonomous runs belong in a real workflow — what to run on a merge, what to run before a release, and how to pace runs so effort and cost match value.
3 min - 11
How to Trigger BlackBat AI from Your CI/CD Pipeline
Call the CI/CD API from GitHub Actions, GitLab CI, or any pipeline to start an exploration or test run and gate a deploy on the result.
7 min - 12
Webhook Notifications: Payload Format and Signature Verification
What BlackBat AI sends to your webhook endpoint: payload, event types, signature verification, retries and troubleshooting. Everything you need to build a receiver.
14 min - 13
How to Turn a Crawl into Documentation, User Stories and Test Coverage
After a full crawl, BlackBat AI can write up how your app works and turn it into user stories you can cover with test plans. Here's how to generate it, review it and close the gaps.
3 min
See it on your own app
Point BlackBat AI at a URL and get a map of your app plus a list of what's broken. Free.
Start Free