Agentic testing

Share a run

A share link turns one finished run into a public report page that anyone with the link can open, with no Coldtea account and no sign-in. Use it to hand a result to someone outside the app: a designer, a customer, a teammate without access.

This is different from the GitHub-gated report used in PR reporting. That report checks that the viewer can read the bound repo. A share link skips that check: the link itself is the credential.

A share link is the run's report URL carrying a share token, for example /qa/runs/<run-id>?t=<token>. The token is a bearer credential. Anyone who has the link can open the report, so treat the link like a secret and share it only with people who should see the run.

Minting a link is a deliberate act against one named run. An agent does it with qa_run_share, which returns the public URL for that run. See MCP and local API.

The share token is derived from the run id, so the same run always produces the same link, and there is no per-link revoke. The only way to invalidate an issued link is a backend secret rotation, which invalidates every share link at once. Mint a share link only when you mean the run to be openly reachable.

What the shared report shows

The public report shows the run's verdict, summary, steps, screenshots, target, and the recording. It leaves out everything internal to Coldtea: credentials, tenancy ids, storage keys, live endpoints, log files, and Matcha's internal scaffolding steps. Media loads through signed URLs rather than exposing storage locations.

Social card

A shared report carries a preview card for social and chat. When someone pastes the link into a tool that unfurls links, the card shows the run's title, its verdict summary, and how many steps passed, rendered as an image. The card is gated on the same share token as the report, so a link without the token unfurls to nothing.

Runs and results

How to read one run: the statuses it moves through, the verdict or couldn't-run reason it ends on, and the evidence Matcha collected.

PR reporting

Bind a GitHub repo and Matcha runs against your changes, keeping one pull-request comment that summarizes the runs and links each report.

On this page

What a share link isThe link is not revocableWhat the shared report showsSocial cardRelated