cypress-tap
Drives a running Cypress open-mode session through `cypress tap` to run and rerun specs, wait for fresh results, inspect reporter and command logs, and query or rewind the app under test through DOM, accessibility, styles, and snapshots. Use when authoring or debugging Cypress e2e or component specs, discovering selectors, diagnosing failures, or verifying test behavior without GUI interaction. Not for one-shot headless runs. Requires Cypress 15.21+, a Chromium-family browser, and a running `cypress open` session.
Install
With your agent
Install OMGSkills skill "cypress-io/ai-toolkit:skills/cypress-tap" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/cypress-io/ai-toolkit /tmp/ai-toolkit && ln -s /tmp/ai-toolkit/skills/cypress-tap ~/.claude/skills/cypress-tap
From README
Driving Cypress with cypress tap cypress tap controls an already-running cypress open session. Use it to iterate on specs, inspect the reporter and command log, and read the app under test without GUI interaction. Use cypress run instead for a one-shot headless batch. Core loop run is asynchronous. A stale verdict matches a fresh one on every field except startedAt, and a watcher rerun of the selected spec can advance startedAt without running your file. Gate on startedAt, spec, and a terminal status. Do not wait to observe running — fast specs can finish between polls. Copy-paste poller: session-lifecycle.md. JSON field helpers: json-recipes.md. In poll loops, prefer ./nodemodules/.bin/cypress tap … over npx cypress tap … when the project pins Cypress. Prerequisites Confirm from package metadata or the lockfile that the resolved Cypress is 15.21.0+ and contains tap.
More from this repo
cypress-author
Creates, updates, and fixes Cypress tests (E2E/end-to-end and component tests).
cypress-cloud-cli
Runs the cy-cloud CLI to inspect Cypress Cloud organizations, projects, runs, specs, tests, failure screenshots, and...
cypress-docs
Used to search and extract Cypress information from official documentation (docs.cypress.io, cypress.io); prefer LLM...
