Repository navigation
docs: add an agent sandbox guide and fix the Cursor environment files - #35109
Open
mike-plummer wants to merge 2 commits into
Open
mike-plummer wants to merge 2 commits into
mike-plummer wants to merge 2 commits into
Conversation
mike-plummer
force-pushed
the
mikep/tap-agent-sandbox-guide
branch
from
October 21, 2026 16:35
778959a to
3682a68
Compare
![cypress-bot[bot]](https://avatars.githubusercontent.com/in/24384?s=60&v=4){kind=small}
mike-plummer
force-pushed
the
mikep/tap-agent-sandbox-guide
branch
from
October 21, 2026 18:04
3682a68 to
2c8d618
Compare
mike-plummer
marked this pull request as ready for review
October 21, 2026 18:29
cypress
 |
||||||||||||||||||||||||||||||||||||||||
| Project |
cypress
|
| Branch Review |
mikep/tap-agent-sandbox-guide
|
| Run status |
|
| Run duration | 16m 19s |
| Commit |
|
| Committer | Mike Plummer |
| View all properties for this run ↗︎ | |
| Test results | |
|---|---|
 |
0
|
 |
14
|
 |
1034
|
 |
0
|
 |
29922
|
| View all changes introduced in this branch ↗︎ | |
UI Coverage
67.12%
|
|
|---|---|
|
|
24
|
|
|
49
|
Accessibility
98.98%
|
|
|---|---|
|
|
0 critical
3 serious
2 moderate
0 minor
|
|
|
18
|
Adds a guide for running cypress open and driving it with cypress tap from an AI agent in a sandbox: requirements, agent mode, choosing a browser, what each failure looks like, and how to set up Claude Code on the web and Cursor Cloud. It marks what has not been verified on a host. Points to the guide from AGENTS.md. The Cursor Cloud Dockerfile used the Node 22.19.0 image and claimed it matched .node-version, which is 24.15.0. It now uses the 24.15.0 image the monorepo's CI uses. Jira: AW-188 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
mike-plummer
force-pushed
the
mikep/tap-agent-sandbox-guide
branch
from
October 26, 2026 18:04
622dadd to
22686b8
Compare
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Additional details
Adds
guides/using-cypress-tap-in-agent-sandboxes.md, indexed inguides/README.md: requirements, the launch recipe, agent mode andCYPRESS_AGENT_MODE, choosing a browser, troubleshooting, and Claude Code on the web and Cursor Cloud setup. It links fromAGENTS.mdand corrects its claims about Chrome andELECTRON_RUN_AS_NODE..cursor/Dockerfilemoves tocypress/base-internal:24.15.0-trixieand its Node comment is fixed.The guide describes behavior from the other agent-sandbox PRs, including the separate CLI PRs, so it should merge last. Claims that have not been checked on the host named are marked unverified.
Stack: one of 7 stacked draft PRs (see the stack on GitHub). Merge in order from the bottom: PR with
tap-keep-live-sessions,tap-print-open-mode-errors,tap-agent-welcome-bypass,tap-agent-no-config-start,tap-status-load-errors,tap-browser-path-detection, then the guidetap-agent-sandbox-guidelast, since it describes behavior from the other PRs (including the CLI PRs that are not in this stack).Jira: AW-188
Note
Low Risk
Documentation and Cursor Cloud Dockerfile base-image bump only; no runtime product code changes.
Overview
Adds
guides/using-cypress-tap-in-agent-sandboxes.md(indexed inguides/README.md) documenting how agents runcypress openand drive tests viacypress tap: launch/wait recipe, Xvfb and network requirements, agent mode /CYPRESS_AGENT_MODE, browser choice, troubleshooting, and host-specific setup for Claude Code on the web vs Cursor Cloud.AGENTS.mdnow links to that guide, clarifies that Chrome in Cursor comes from the host (not.cursor/Dockerfile), and adds a short Drivingcypress openwithcypress tapsection..cursor/Dockerfileupdates the Cursor Cloud dev image fromcypress/base-internal:22.19.0-trixieto24.15.0-trixieso it matches.node-versionand CI’scy-dockerexecutor.Reviewed by Cursor Bugbot for commit 622dadd. Bugbot is set up for automated code reviews on this repo. Configure here.
Steps to test
How has the user experience changed?
No change to product behavior. Documentation and environment files only.
PR Tasks
cypress-documentation?type definitions?🤖 Generated with Claude Code