Documentation
How LitmusRun works
LitmusRun is an AI agent product for synthetic user validation and QA. A panel of agents opens your web app in an isolated Chromium browser, acts like your target users, and returns ranked findings with session evidence.
The loop
- Paste your URL, set the mission, and choose how deep the study should go.
- AI agents browse, click, hesitate, and rage-tap in real time as synthetic users.
- Live thoughts and session frames stream to the agent room.
- The report lists validation and QA findings, persona takes, and a consensus summary of what to fix first.
What you can test
- Web apps and user flows on staging or production, with heatmaps, session evidence, and live thoughts.
- Full products, single features, or paths like signup and checkout.
Get started
Sign up free with 20 credits, paste a product URL, set the mission, and launch a panel study from the dashboard. Upgrade anytime for more monthly credits and larger agent panels.
CI & API
Launch studies from CI or scripts with a profile API key. Create keys in Profile → API.
curl -X POST https://litmusrun.com/api/v1/studies \
-H "Authorization: Bearer lr_<your_api_key>" \
-H "Idempotency-Key: deploy-$UNIQUE_ID" \
-H "Content-Type: application/json" \
-d '{
"projectId": "<project_id>",
"missionGoal": "Complete signup without reading the docs",
"studyType": "standard",
"agentCount": 12
}'
curl https://litmusrun.com/api/v1/studies/<study_id> \
-H "Authorization: Bearer lr_<your_api_key>"- Authorization —
Bearer lr_…profile API key from Profile → API. - Idempotency-Key — required unique string per launch (retries reuse the same panel run).
- Body —
projectId,missionGoal; optionalartifactUrl,studyType(smoke|standard|deep),agentCount(3–80).
Prefer the dashboard for interactive launches? Open the launch wizard →