Cypress Cloud CLI (cy-cloud)

The Cypress Cloud CLI puts your Cypress Cloud run data and Test Replay in your terminal as structured JSON. It is published as @cypress/cloud and installs the cy-cloud binary. Use it to triage failed runs yourself, script it in CI, or hand it to a shell-based coding agent.

With cy-cloud you can access your organizations, projects, runs, specs, and test results. Check run status, save screenshots of test failures, or query the Test Replay timeline for the exact test commands, network logs, and dev console logs from any run.

Use it to build automation, scripts, and custom tooling on top of Cypress Cloud.

Requirements

To access Cypress Cloud data you must

• Have a Cypress Cloud account
• Have the integration enabled for your Cloud organization
• Be using Node.js >= 22.21.0

Getting started

npm install -g @cypress/cloud
cy-cloud login
cy-cloud --help # every command supports `--help`.

Documentation

Review the full documentation, including the complete command reference, caching, rate limits, and examples.

License

Use of this library is subject to your Cypress Cloud subscription terms and Cypress Terms of Use.