{
  "slug": "cypress-adds-cypress-tap-for-open-mode-sessions-5530c638d6f7",
  "title": "Cypress adds cypress tap for open-mode sessions",
  "tools": [
    "cypress"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-08-18T00:00:00.000Z",
  "announced_at": "2026-08-18T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When a Cypress 15.21.0+ open-mode session is running in a supported Chromium-based browser, use `cypress tap` to run or rerun a spec, poll its status, inspect failure details, and read the app’s DOM or accessibility tree.",
    "examples": [
      "npx cypress tap sessions\nnpx cypress tap run <spec-path>\nnpx cypress tap status --json",
      "npx cypress tap reporter --test-id <test-id>\nnpx cypress tap command --test-id <test-id> --command-id <command-id>",
      "npx cypress tap dom\nnpx cypress tap aria\nnpx cypress tap aria --json"
    ],
    "gotchas": [
      "Version: 15.21.0",
      "<spec-path> (required): Spec path relative to the project; `run` runs or reruns that spec.",
      "--test-id <test-id> (required): Selects a test for its reporter view or Command Log entry.",
      "--command-id <command-id> (required): Selects a Command Log entry; the ID is listed by the reporter command.",
      "--json: Requests machine-readable JSON output.",
      "--session <pid> / -s <pid>: Targets a specific running session by its listed PID.",
      "Prerequisite: Requires Cypress v15.21.0 or later and a running `cypress open` session; does not work with headless `cypress run`.",
      "Prerequisite: Supports Chrome, Chromium, Edge, and Electron; Firefox and WebKit are unsupported.",
      "Prerequisite: Run tap commands from the same project directory as the open session, or specify `--session <pid>`. No Cypress Cloud account or paid subscription is required.",
      "The command accesses open-mode Cypress sessions running on the machine.",
      "Output is readable by default; `--json` selects machine-readable JSON.",
      "Docs conflict: The current documentation describes `cypress tap` behavior after 15.21.0 and was updated after the card’s version; it documents additional subcommands and later behavior changes. The 15.21.0 release note confirms the card’s listed capabilities and `--json` behavior."
    ]
  },
  "why_it_matters": "Inspect and rerun a failing spec in an open-mode Cypress session while debugging repository tests.",
  "sources": [
    "https://docs.cypress.io/app/references/changelog#15-21-0",
    "https://docs.cypress.io/app/tooling/cypress-tap"
  ],
  "rank": 0.99062,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave2b-20261017",
    "verdict_id": "wave2b-20261017:wave2b-20261017-1c478e82ae9fa774-1:gate",
    "evidence_hash": "fca29c120f5eea5f6095577c15a98e359f5ef518a880f01e99d4043655591066"
  },
  "review": {
    "draft_hash": "3ce1cacdc69bc1f29da80eb5a496819fd06dc183d8cdccc8a4620030a1bbd611",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave2b-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.99 >= 0.9; 2 needed) and Jev gave 0.75 (>= 0.6 needed)."
  }
}