Runs

A run is one execution of a project’s Playwright suite, reported by CI. Runs carry the commit, branch, author, tags, and status, plus the aggregate pass/fail counts. For fields and response details, see the API reference.

List runs

This command lists the runs recorded for a project, newest first. Use this when you start triage: filter to the branch and the status you are chasing.

neetoplaydash runs list pdqmxlz --branch main --status failed

Required arguments:

<project_id> - the project whose runs to list, from projects list.

Flag	Type	Default	Description
`--branch`	`string`		Filter runs by branch name
`--page`	`int`	`0`	Page number
`--page-size`	`int`	`0`	Items per page (max 50)
`--status`	`string`		Filter runs by status (e.g. passed, failed, running)

--status takes exactly one of running, passed, failed, passing, failing, timedOut, interrupted. The server caps this endpoint at 50 records per page. A larger --page-size prints a warning on standard error, and the server clamps the page to 50. Check pagination.page_size in the response for the size actually applied.

Sample output (--json)

{
  "data": [
    {
      "id": "kftwnab",
      "commit_id": "9fceb02e1d2c4bb6a1f3f6b0c8e7d5a1b2c3d4e5",
      "created_at": "2026-06-28T09:14:22.000Z",
      "commit_name": "Fix flaky checkout spec",
      "status": "failed",
      "duration": 182.45,
      "ci_build_id": "gh-actions-4821",
      "branch": "main",
      "author": "Oliver Smith",
      "tags": ["smoke", "nightly"],
      "is_running": false,
      "run_statistics": [
        { "name": "Passed", "value": 38 },
        { "name": "Failed", "value": 2 },
        { "name": "Flaky", "value": 1 }
      ]
    }
  ],
  "breadcrumbs": [
    { "label": "Show run", "command": "neetoplaydash runs show <run_id> --project <project_id>" },
    { "label": "List test entities", "command": "neetoplaydash test-entities list <run_id> --project <project_id>" }
  ],
  "pagination": {
    "total_records": 42,
    "total_pages": 3,
    "current_page_number": 1,
    "page_size": 15
  }
}

Every run the project holds is listed, including one that reported no test attempts at all. Such a run still carries its commit, branch, and status, but its run_statistics is empty and test-entities list reports nothing for it.

Show a run

This command shows one run with its summary, aggregate statistics, and the spec files it executed, each with the tests grouped under it. Use this when you want the shape of a whole run in a single call rather than paging through its test entities. get is still accepted as an alias for show.

neetoplaydash runs show kftwnab --project pdqmxlz

Required arguments:

<run_id> - the run to show, from runs list.
--project <project_id> - the project the run belongs to.

Flag	Type	Required	Default	Description
`--project`	`string`	Yes		Id of the project the resource belongs to

Sample output (--json)

{
  "data": {
    "project_id": "pdqmxlz",
    "run_id": "kftwnab",
    "commit_id": "9fceb02e1d2c4bb6a1f3f6b0c8e7d5a1b2c3d4e5",
    "created_at": "2026-06-28T09:14:22.000Z",
    "commit_name": "Fix flaky checkout spec",
    "status": "failed",
    "duration": 182.45,
    "ci_build_id": "gh-actions-4821",
    "branch": "main",
    "author": "Oliver Smith",
    "tags": ["smoke", "nightly"],
    "is_running": false,
    "total_shards": 4,
    "run_statistics": [
      { "name": "Passed", "value": 38 },
      { "name": "Failed", "value": 2 }
    ],
    "specs": [
      {
        "spec_id": "wbnxtyz",
        "file_name": "cart.spec.ts",
        "tests": [
          {
            "test_id": "vhrscje",
            "title": "adds an item to the cart",
            "status": "passed",
            "duration": 3.21
          }
        ]
      }
    ],
    "pagination": {
      "total_records": 12,
      "total_pages": 1,
      "current_page_number": 1,
      "page_size": 15
    }
  },
  "breadcrumbs": [
    { "label": "List test entities", "command": "neetoplaydash test-entities list <run_id> --project <project_id>" }
  ]
}

The specs list is paginated, and its pagination object sits inside data alongside it. See the API reference for the full response.

Getting started

Commands

List runs

Show a run

​List runs

​Show a run

List runs

Show a run