Using the e2e framework by TesterArmy? Follow E2E instead.
Prerequisites
- A TestDino account
- A Playwright project with tests (or the TestDino Example Repository )
- Node.js
>= 18and@playwright/test>= 1.52 - A project API key from Generate API Keys (agents need
TESTDINO_TOKENset)
Set up with an AI agent
Paste this into Cursor, Claude Code, or another coding assistant:Add @testdino/playwright to your Playwright config, then run your tests.
TESTDINO_TOKEN, run npx playwright test, and confirm the run appears in Test Runs. For MCP, docs for agents, and more prompts, see AI Onboarding.
Set up your first project
Follow these steps if you prefer to configure TestDino yourself.1
Create a project
Sign up, then name your organization on the onboarding screen and answer the 3 setup questions. TestDino lands you on Projects with the Create project dialog already open, so name the project to finish. Later projects start from the New Project card on that page.A project with no test runs opens on a Connect this project guide that covers the same steps as below, By hand or With an agent, with an API key already created for it.

2
Get your API key
Go to Project Settings → API Keys and create a new key. Copy it once; it is shown only at creation. Full key options are in Generate API Keys.

3
Export your API key
Store the key in The variable lasts until you close the terminal, so run your tests in the same terminal.
TESTDINO_TOKEN:- macOS / Linux
- Windows (PowerShell)
Never hardcode the key in source. In CI, store it as a secret named
TESTDINO_TOKEN.4
Install the package
5
Add TestDino to your Playwright config
Add
@testdino/playwright to the reporter array. Keep any existing reporters you already use. If you have none, keep Playwright’s default terminal output as shown, since a reporter array replaces it.playwright.config.ts
Prefer not to edit your config?
Prefer not to edit your config?
Run Playwright flags pass through, for example
tdpw test instead of npx playwright test:npx tdpw test --project=chromium --shard=1/3.6
Run your tests
7
Verify in TestDino
Open Test Runs. Your run appears at the top with pass/fail counts and duration. Open the run to see its test cases, traces, and screenshots. The TestDino summary in your terminal also includes a 
View run link to the run.
No run showing up? Confirm
TESTDINO_TOKEN is set and @testdino/playwright is in your reporter array. See FAQs and Troubleshooting.CI Setup
Stream results from GitHub, GitLab, Azure DevOps, and more
Generate API Keys
Create and store project API keys
TestDino MCP
Query test data from an AI assistant
Integrations
Slack, Jira, GitHub, and more