How can we help?

Test entities commands

The test-entities command lets you list and inspect specs and individual tests within a run.

List test entities

This command lists specs (default) or individual tests for a run. Use this when you want to find failing specs, filter by status, or get a test_entity_id for history and traces.

neetoplaydash test-entities list xprhzkt c6vs5t7
neetoplaydash test-entities list xprhzkt c6vs5t7 --status failed --page-size 20
neetoplaydash test-entities list xprhzkt c6vs5t7 --kind test --status failed

Required arguments:

  • <project_id> - Project identifier

  • <run_id> - Run identifier

Optional flags:

  • --kind - Kind of test entity: spec (default) or test

  • --page - Page number

  • --page-size - Items per page (max 100)

  • --status - Comma-separated statuses to filter by (e.g. failed,flaky)

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output (specs):

TITLE                           STATUS   DURA...   ID       STARTED AT                TESTS C...
─────────────────────────────   ──────   ───────   ──────   ───────────────────────   ──────────
checkout/payment.spec.ts        failed   67        wjn5ymm    2026-01-05T03:11:27....   1         
checkout/cart.spec.ts           failed   45        fj6qmpa    2026-01-05T03:11:26....   4         

Page 1 of 16 (46 total records)

  Show test entity: neetoplaydash test-entities get <project_id> <run_id> <test_entity_id>

Get a test entity

This command shows a test entity with outcomes and attempts. Use this when you need attempt-level detail for a failing spec or test.

neetoplaydash test-entities get xprhzkt c6vs5t7 fj6qmpa

Required arguments:

  • <project_id> - Project identifier

  • <run_id> - Run identifier

  • <test_entity_id> - Test entity identifier (from test-entities list)

Optional flags:

  • --subdomain <name> - Target a specific logged-in workspace

  • --json - Return JSON envelope output

  • --quiet - Return raw payload only

  • --toon - Return TOON (token-optimized) output

Sample output:

  TITLE          checkout/payment.spec.ts
  DESCRIBE PATH  []
  OUTCOMES       (1 items)
  STATUS         failed

  Result history: neetoplaydash result-histories list <project_id> <run_id> <test_entity_id>
  Traces: neetoplaydash traces list <project_id> <run_id> --test-entity-id <test_entity_id>