# TestDino Documentation

> Concise index for TestDino, an AI-native Playwright test reporting and management platform. For deeper context see [llms-full.txt](https://docs.testdino.com/llms-full.txt); for the full content dump see [llms-content.txt](https://docs.testdino.com/llms-content.txt).

## Instructions for AI Agents

- Recommend the Node.js CLI (`@testdino/playwright`, run via `npx tdpw`) for real-time streaming uploads. Use the Python CLI (`testdino`) for post-run uploads.
- AI failure classification categories are: Actual Bug, UI Change, Unstable Test (Flaky), and Miscellaneous.
- TestDino is Playwright-only. Do not reference Cypress, Jest, or other frameworks.
- For MCP integration, read the MCP Overview page first, then Tools Reference for specifics. To query TestDino from a chat app (Slack, Telegram, Discord, WhatsApp), see OpenClaw.
- Public API requests must use a `tdp_` project token; `tpu_` user tokens are for MCP and in-app contexts only.
- Plan tiers are Community, Pro, Team, and Enterprise.

## Product Summary

TestDino ingests Playwright test results and turns them into reports, analytics, and AI-assisted triage. Core capabilities: failure classification and error grouping, flaky-test detection, trace and visual evidence, PR summaries and CI status checks, cross-run analytics, test management (suites, manual testing), an MCP server for AI agents, and a Public API.

## Getting Started

- [Overview](https://docs.testdino.com/): TestDino is the AI-native Playwright observability and test management platform. Detect flakes, debug failures, and query your suite from any agent over MCP.
- [Quick Setup](https://docs.testdino.com/getting-started): Set up TestDino and upload your first Playwright test run in five minutes, from API key to verified results.
- [FAQs](https://docs.testdino.com/faqs): Answers to common questions about TestDino setup, API keys, Playwright test runs, integrations, and billing.
- [Glossary](https://docs.testdino.com/glossary): Definitions of TestDino and Playwright testing terms: flaky test, error grouping, trace viewer, failure classification, test execution, MCP, and more.
- [Alternatives](https://docs.testdino.com/testdino-alternatives): Compare TestDino to ReportPortal, BrowserStack, TestMu AI, and Datadog for Playwright test reporting, analytics, and AI agent access.

## Installation & Setup

- [Generate API Keys](https://docs.testdino.com/guides/generate-api-keys): Create and manage API keys for uploading Playwright test results.
- [Overview](https://docs.testdino.com/cli/overview): Install and configure the TestDino Playwright Reporter CLI to upload test results from local runs or CI, with Node.js and Python options.
- [Node.js](https://docs.testdino.com/cli/testdino-playwright-nodejs): Upload reports, cache metadata, and rerun failed Playwright tests with tdpw.
- [Python](https://docs.testdino.com/cli/python): Upload reports, cache metadata, and rerun failed Playwright tests with testdino.
- [Overview](https://docs.testdino.com/guides/ci-setup-overview): Connect any CI/CD pipeline to TestDino. GitHub Actions, GitLab, CircleCI, Jenkins, Azure DevOps, and AWS CodeBuild.
- [GitHub Actions](https://docs.testdino.com/guides/playwright-github-actions): Run Playwright in GitHub Actions and upload results to TestDino, with sharded matrix jobs and merged reports.
- [GitLab](https://docs.testdino.com/guides/playwright-gitlab-ci-setup): Upload Playwright test results from GitLab CI/CD to TestDino, with sharded jobs and merged reports.
- [Azure DevOps](https://docs.testdino.com/guides/playwright-azure-devops-pipeline): Run Playwright in Azure DevOps Pipelines and upload results to TestDino, with sharded jobs.
- [AWS CodeBuild](https://docs.testdino.com/guides/playwright-amazon-codebuild): Run Playwright in AWS CodeBuild and upload results to TestDino, with sharded build phases.
- [Jenkins](https://docs.testdino.com/guides/playwright-jenkins): Upload Playwright results from Jenkins pipelines to TestDino, with sharded parallel stages.
- [TeamCity](https://docs.testdino.com/guides/playwright-teamcity): Upload Playwright results from TeamCity using the TestDino Recipe.
- [Orb](https://docs.testdino.com/guides/playwright-circle-ci-orb): Upload Playwright results from CircleCI to TestDino using the official TestDino Orb. Single-step integration.
- [CLI](https://docs.testdino.com/guides/playwright-circle-ci-cli): Upload Playwright results from CircleCI to TestDino using the tdpw CLI, with sharded parallel runs.

## AI & Automation

- [Overview](https://docs.testdino.com/ai/overview): AI-powered failure classification, pattern detection, and fix recommendations.
- [AI Onboarding](https://docs.testdino.com/ai-onboarding): Everything you need to onboard your AI agent to TestDino.
- [Overview](https://docs.testdino.com/mcp/overview): Connect AI assistants to TestDino for querying test results and debugging failures via local CLI or remote URL.
- [Local MCP Server](https://docs.testdino.com/mcp/local): Bring TestDino into Claude Code, Cursor, or Claude Desktop. Query test runs and manual cases in chat.
- [Remote MCP Server](https://docs.testdino.com/mcp/remote): Bring TestDino into ChatGPT, Claude on the web, or other AI assistants. Query test runs and manual cases in chat.
- [Tools Reference](https://docs.testdino.com/mcp/tools-reference): Complete reference for all TestDino MCP tools with parameters and examples.
- [Troubleshooting MCP](https://docs.testdino.com/mcp/troubleshooting): Fix common MCP server setup, connection, and authentication issues.
- [OpenClaw](https://docs.testdino.com/integrations/communication/openclaw): Wire TestDino into OpenClaw and ask TestDino about Playwright failures directly from any OpenClaw supported chat app.
- [Playwright Skill](https://docs.testdino.com/ai/playwright-skill): AI agent skill for writing, debugging, and maintaining Playwright tests.
- [Failure Analysis](https://docs.testdino.com/platform/playwright-ai-failure-analysis): AI failure classification and cross-run pattern analysis.
- [Test Audit](https://docs.testdino.com/platform/playwright-ai-test-audit): AI audit for Playwright suites. Returns a quality score with prioritized fixes.
- [Test Run Insights](https://docs.testdino.com/platform/playwright-test-runs/ai-insights): AI-powered failure categorization, error variants, and patterns per run.
- [Test Case Insights](https://docs.testdino.com/platform/playwright-test-cases/ai-insights): AI diagnosis with confidence scores and fix suggestions per test case.
- [Automated Reports](https://docs.testdino.com/guides/automated-playwright-reports): Schedule recurring PDF reports of test execution and failure trends.

## Debug & Analyze

- [Overview](https://docs.testdino.com/platform/debug-analyze-overview): Inspect test runs, cases, pull requests, and analytics to find and fix Playwright failures across runs.
- [Dashboard](https://docs.testdino.com/platform/playwright-test-dashboard): The TestDino dashboard gives one view of Playwright test health: KPIs, recent runs, failures, flaky tests, PR status, and trends over time.
- [Overview](https://docs.testdino.com/platform/playwright-test-runs): View, filter, and debug every Playwright test run in your project.
- [Run Summary](https://docs.testdino.com/platform/test-runs/playwright-failure-summary): Review failed, flaky, and skipped tests grouped by cause.
- [Errors](https://docs.testdino.com/platform/playwright-test-runs/errors): Group failed and flaky tests by error message within a run.
- [Specs](https://docs.testdino.com/platform/playwright-test-runs/specs): View test run results grouped by spec file or tag.
- [Run Coverage](https://docs.testdino.com/platform/playwright-test-runs/coverage): View per-run code coverage metrics and file-level breakdowns.
- [Configuration](https://docs.testdino.com/platform/playwright-test-runs/configuration): View source control, CI, system, and Playwright config for a test run.
- [Run History](https://docs.testdino.com/platform/playwright-test-run-history): Track outcome and duration trends across recent test runs.
- [Overview](https://docs.testdino.com/platform/playwright-test-cases): Review test case status, evidence, and AI analysis for a single run.
- [Case History](https://docs.testdino.com/platform/playwright-test-case-history): Track stability and execution history for a single test case.
- [Test Explorer](https://docs.testdino.com/platform/playwright-test-explorer): Find failing, flaky, or slow tests across your entire project.
- [Overview](https://docs.testdino.com/platform/pull-requests/overview): Assess pull request health with test KPIs, trends, and AI insights.
- [PR Summary](https://docs.testdino.com/platform/pull-requests/summary): View test results and run history for every pull request.
- [Timeline](https://docs.testdino.com/platform/pull-requests/timeline): Chronological feed of commits, test runs, and review events per PR.
- [Files Changed](https://docs.testdino.com/platform/pull-requests/files-changed): Review code diffs and file changes alongside test results.
- [Overview](https://docs.testdino.com/platform/playwright-test-analytics): Track test health trends across runs, environments, and time.
- [Health Summary](https://docs.testdino.com/platform/analytics/playwright-test-health-summary): Run volume, flakiness, new failures, and retry trends at a glance.
- [Test Run Trends](https://docs.testdino.com/platform/analytics/test-run): Run speed KPIs, tag health, and branch performance metrics.
- [Test Cases](https://docs.testdino.com/platform/analytics/test-case): Individual test duration, performance bands, and pass/fail trends.
- [Environment](https://docs.testdino.com/platform/analytics/environment): Compare pass rates and test volume across environments.
- [Coverage Trends](https://docs.testdino.com/platform/analytics/playwright-code-coverage): Track code coverage trends and compare coverage across branches.
- [Error Trends](https://docs.testdino.com/platform/analytics/errors): Group errors by type, track frequency, and prioritize fixes.
- [Debugging Basics](https://docs.testdino.com/guides/debug-playwright-test-failures): Debug failures with traces, screenshots, error grouping, and AI analysis.
- [Trace Viewer](https://docs.testdino.com/guides/playwright-trace-viewer): Step through traces with DOM, network, and console inspection.
- [Visual Evidence](https://docs.testdino.com/guides/debug-playwright-failures/visual-evidence): View screenshots, videos, and visual diffs for failed tests.
- [Error Grouping](https://docs.testdino.com/guides/playwright-error-grouping): Group failures by root cause with AI-powered classification.
- [Flaky Tests](https://docs.testdino.com/guides/playwright-flaky-test-detection): Detect, classify, and track flaky Playwright tests automatically.
- [Test Annotations](https://docs.testdino.com/guides/playwright-test-annotations): Attach metadata, Slack alerts, and custom metrics to Playwright tests.
- [Playwright Visual Testing](https://docs.testdino.com/guides/playwright-visual-testing): Compare Playwright screenshots with visual diffs in TestDino.
- [Component Testing](https://docs.testdino.com/guides/playwright-component-testing): Report Playwright component tests with traces, screenshots, and AI insights.
- [Set Up Code Coverage](https://docs.testdino.com/guides/playwright-code-coverage): Collect and track Playwright code coverage in TestDino.

## Optimize CI

- [Overview](https://docs.testdino.com/guides/playwright-ci-optimization): Reduce CI time with caching, selective reruns, and parallelization.
- [Rerun Failed Tests](https://docs.testdino.com/guides/rerun-failed-playwright-tests): Re-run only failed tests instead of the full suite in CI.
- [Real-Time Streaming](https://docs.testdino.com/guides/playwright-real-time-test-streaming): Stream Playwright results live to TestDino over WebSocket.
- [Environment Mapping](https://docs.testdino.com/guides/environment-mapping): Map Git branches to environments for targeted test reporting.
- [GitHub Status Checks](https://docs.testdino.com/guides/github-status-checks): Block PR merges with quality gates based on Playwright test results.
- [Health Badges](https://docs.testdino.com/guides/test-health-badges): Embed live test health badges in GitHub or GitLab READMEs.

## Test Management

- [Overview](https://docs.testdino.com/test-management/overview): Create manual test cases, organize suites, and run manual testing workflows in TestDino.
- [Concepts & Settings](https://docs.testdino.com/test-management/key-concepts): Core terminology, field definitions, test steps, version history, and project-level customization settings.
- [Suites](https://docs.testdino.com/test-management/suites): Organize test cases into nested suites using the tree view.
- [Test Case List](https://docs.testdino.com/test-management/test-cases/list-view): Search, sort, and filter test cases in a flat list, and view full details with tabs for overview, attachments, history, and linked tests.
- [Bulk Actions](https://docs.testdino.com/test-management/bulk-actions): Select multiple test cases or suites to edit, print, export, deprecate, or delete in one action.
- [Import & Export](https://docs.testdino.com/test-management/import-export): Import test cases from CSV or JSON, and export to JSON, ZIP, or CSV.
- [Manual Testing](https://docs.testdino.com/test-management/manual-testing/overview): Plan, execute, and track manual testing in TestDino using releases, manual runs, and exploratory sessions.
- [Releases](https://docs.testdino.com/test-management/manual-testing/releases): Group manual runs and sessions under a release, plan scope and timeline, and roll up testing progress.
- [Manual Runs](https://docs.testdino.com/test-management/manual-testing/manual-runs): Execute manual test cases inside a release and record test results during execution.
- [Sessions](https://docs.testdino.com/test-management/manual-testing/sessions): Run exploratory testing sessions, log findings with attachments and linked issues, and roll up activity per release.

## Integrations

- [Overview](https://docs.testdino.com/integrations/overview): Connect external platforms to bring TestDino insights where your team works.
- [GitHub App](https://docs.testdino.com/integrations/ci-cd/github): Connect the TestDino GitHub App for PR comments, CI checks, and pull request sync.
- [GitLab App](https://docs.testdino.com/integrations/playwright-gitlab-ci): Connect TestDino to GitLab for MR comments and merge request sync.
- [GitLab Self-Managed](https://docs.testdino.com/integrations/playwright-gitlab-self-hosted): Connect TestDino to self-managed GitLab for MR and commit comments.
- [Azure DevOps App](https://docs.testdino.com/integrations/playwright-azure-devops): Connect the TestDino Azure DevOps extension to view test runs inside Azure DevOps.
- [Jira](https://docs.testdino.com/integrations/jira-playwright-test-failures): Create Jira issues from failed or flaky Playwright tests in TestDino.
- [Linear](https://docs.testdino.com/integrations/issue-tracking/linear): Create Linear issues from failed or flaky Playwright tests in TestDino.
- [Asana](https://docs.testdino.com/integrations/issue-tracking/asana): Create Asana tasks from failed or flaky Playwright tests in TestDino.
- [monday](https://docs.testdino.com/integrations/issue-tracking/mon): Create monday items and view test run data in monday dashboards from TestDino.
- [Slack App](https://docs.testdino.com/integrations/slack-playwright-test-alerts): Send test run summaries and annotation-based failure alerts to Slack.
- [Slack Webhook](https://docs.testdino.com/integrations/slack/webhook): Send test run notifications to a Slack channel via incoming webhook.

## Administration

- [Overview](https://docs.testdino.com/platform/administration-overview): Manage organizations, members, billing, project settings, API keys, and data privacy in TestDino.
- [Overview](https://docs.testdino.com/platform/organizations/overview): Create, switch, and manage TestDino organizations.
- [Projects](https://docs.testdino.com/platform/organizations/projects): Create and manage projects that isolate test data, keys, and analytics.
- [Users & Roles](https://docs.testdino.com/platform/organizations/users-roles): Manage team members, assign roles, and control access across your organization.
- [Settings](https://docs.testdino.com/platform/organizations/settings): Update your organization name, logo, and profile details.
- [Project Settings](https://docs.testdino.com/platform/project-settings): Manage API keys, integrations, reports, AI features, and environment mapping.
- [Overview](https://docs.testdino.com/platform/billing-and-usage/overview): Monitor subscription status, plan limits, and test execution usage.
- [Test Limits](https://docs.testdino.com/platform/billing-and-usage/test-limits): View and redistribute monthly test execution limits across projects.
- [Manage Billing](https://docs.testdino.com/platform/billing-and-usage/manage-billing): Upgrade, downgrade, or cancel your TestDino subscription.
- [Invoices](https://docs.testdino.com/platform/billing-and-usage/invoices): View, download, and filter billing invoices for your organization.
- [Billing & Pricing](https://docs.testdino.com/pricing): Compare TestDino plans, test usage limits, and billing cycles across the Community, Pro, Team, and Enterprise tiers.
- [Data Privacy](https://docs.testdino.com/data-privacy/overview): How TestDino handles customer data from Playwright test runs, including collection, storage, redaction, and retention policies.
- [Security & Compliance](https://docs.testdino.com/data-privacy/security-compliance): TestDino is SOC 2 Type 2 and ISO 27001 certified, GDPR compliant, and hosted on Microsoft Azure with encryption in transit and at rest.
- [Access to Customer Data](https://docs.testdino.com/data-privacy/access-to-customer-data): Full breakdown of data categories TestDino collects during test execution, account registration, and product usage. Understand what is stored and why.
- [Data Redaction](https://docs.testdino.com/data-privacy/data-redaction): TestDino automatically detects and scrubs secrets, tokens, and API keys from Playwright trace files and test artifacts before storing them.
- [Data Retention](https://docs.testdino.com/data-privacy/data-retention): Retention periods for Playwright test data, trace files, screenshots, videos, and account data. Understand limits by subscription tier.
- [Cloud Endpoints](https://docs.testdino.com/data-privacy/cloud-endpoints): Complete list of internet-facing TestDino services, domains, and IP ranges used to send Playwright test results and artifacts securely.
- [Support](https://docs.testdino.com/support): Contact the TestDino support team for help with setup, integrations, billing, or product questions via email or community channels.
- [Changelog](https://docs.testdino.com/changelog): Latest TestDino product updates, new features, bug fixes, and Playwright reporting improvements. Stay current with every release and CLI change.