# cypress-tap

> Claude/Codex skill by [@cypress-io](https://omgskills.com/library/cypress-io/index.md) · 47 stars · Updated 2026-10-23

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.

Tags: agent-skills, ai, ai-tools, cypress, skills, testing

## Install

```sh
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.

## Links

- HTML page: https://omgskills.com/library/cypress-io/ai-toolkit/skills/cypress-tap/
- GitHub: https://github.com/cypress-io/ai-toolkit
- Author: [@cypress-io](https://omgskills.com/library/cypress-io/index.md)

## More from this repo

- [cypress-author](https://omgskills.com/library/cypress-io/ai-toolkit/skills/cypress-author/index.md) — Creates, updates, and fixes Cypress tests (E2E/end-to-end and component tests).
   - [@cypress-io](https://omgskills.com/library/cypress-io/index.md) · 47 stars
- [cypress-cloud-cli](https://omgskills.com/library/cypress-io/ai-toolkit/skills/cypress-cloud-cli/index.md) — Runs the cy-cloud CLI to inspect Cypress Cloud organizations, projects, runs, specs, tests, failure screenshots, and...
   - [@cypress-io](https://omgskills.com/library/cypress-io/index.md) · 47 stars
- [cypress-docs](https://omgskills.com/library/cypress-io/ai-toolkit/skills/cypress-docs/index.md) — Used to search and extract Cypress information from official documentation (docs.cypress.io, cypress.io); prefer LLM...
   - [@cypress-io](https://omgskills.com/library/cypress-io/index.md) · 47 stars