feat: cy.prompt experimental command [Feature Flagged]

[ryanthemanuel]

• Closes Prompt: cy.prompt – Ability to generate Cypress tests from natural language #31826

Additional details

We've implemented a new experimental command: cy.prompt() (that is still gated behind a feature flag). It will let you write tests using natural language prompts, like:

cy.prompt([
  `Visit https://aicotravel.com`,
  `Type Paris in "where do you want to go"`,
  `Click on the first result`,
  `Click on the number of day picker`,
  `Click on 4 days`,
  `Press the Create Itinerary Button`
])

Cypress will translate this into test steps, execute them, and adapt as the application under test changes (similar to self-healing behavior).

Steps to test

How has the user experience changed?

PR Tasks

• Have tests been added/updated?
• Has a PR for user-facing changes been opened in cypress-documentation?
• Have API changes been updated in the type definitions?

---

Note

Adds a feature-flagged experimental cy.prompt command powered by a cloud-delivered bundle, with app/reporter UI, server/browser integration, a new experimentalPromptCommand config flag, and comprehensive tests.

• Experimental Command:
  • Introduces cy.prompt (feature-flagged) with new experimentalPromptCommand config; reserves command name; adds error handling and types.
  • Driver: implements command, cloud bundle init/download timeout/SSL errors, cross-origin backend request handling, preserveRunState helper.
• App/Reporter UI:
  • New Vue modals (PromptGetCodeModal, PromptMoreInfoNeededModal) and Pinia prompt-store.
  • Reporter shows “Get code” action for prompt logs; supports custom docs URL titles; minor log group defaults.
• Server/Cloud:
  • Adds CyPromptLifecycleManager/CyPromptManager, routes, socket listeners, bundle download/verification, error reporting, and connection via CDP.
  • New cloud APIs: create session, get bundle, report errors; non-retriable cert error codes.
• Browsers:
  • Chrome/Electron: connectCyPromptToBrowser; CRI client clones/manages additional target; reset/close updates.
• Core/Data:
  • Data context actions to track current run/instance; HTML serve tweaks for simulated open mode.
• Types/Tooling:
  • New types for prompt (app/driver/server); gulp task to download prompt types; config/tests updated; changelog entry.
• CI/Infra:
  • CircleCI filters/branches tweaked; snapshot/hash updates; system/unit/e2e tests added.

^{Written by Cursor Bugbot for commit 3b81d4b. This will update automatically on new commits. Configure here.}

[cypress]

cypress    Run #66187

Run Properties:   Passed #66187  •  3b81d4bef6: fix build

Project	cypress
Branch Review	feat/cy-prompt
Run status	Passed #66187
Run duration	17m 52s
Commit	3b81d4bef6: fix build
Committer	Ryan Manuel
View all properties for this run ↗︎

---

Test results
Failures	0
Flaky	2
Pending	132
Skipped	0
Passing	5590
View all changes introduced in this branch ↗︎

[ryanthemanuel]

The code owner approval was here: #31752 (comment)

[cypress-bot]

Released in 15.4.0.

This comment thread has been locked. If you are still experiencing this issue after upgrading to
Cypress v15.4.0, please open a new issue.