[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-cypress-cypress-cloud-cli":3,"mdc--p4d0ae-key":41,"related-org-cypress-cypress-cloud-cli":927,"related-repo-cypress-cypress-cloud-cli":994},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":26,"repoUrl":27,"updatedAt":28,"license":29,"forks":30,"topics":31,"repo":36,"sourceUrl":39,"mdContent":40},"cypress-cloud-cli","inspect Cypress Cloud test and run data","Runs the cy-cloud CLI to inspect Cypress Cloud organizations, projects, runs, specs, tests, failure screenshots, and Test Replay data. Use when the user mentions Cypress Cloud, cy-cloud, cypress-cloud-cli, a Cloud run or test URL, failing or flaky Cypress tests, Test Replay, run triage, Cloud artifacts, or asks why a recorded test failed.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"cypress","Cypress","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fcypress.png","cypress-io",[13,17,20,23],{"name":14,"slug":15,"type":16},"Observability","observability","tag",{"name":18,"slug":19,"type":16},"CLI","cli",{"name":21,"slug":22,"type":16},"Testing","testing",{"name":24,"slug":25,"type":16},"Debugging","debugging",39,"https:\u002F\u002Fgithub.com\u002Fcypress-io\u002Fai-toolkit","2026-08-29T09:48:07.747495",null,3,[32,33,34,8,35,22],"agent-skills","ai","ai-tools","skills",{"repoUrl":27,"stars":26,"forks":30,"topics":37,"description":38},[32,33,34,8,35,22],"Fast, flexible, and open tooling for building intelligent workflows with Cypress.","https:\u002F\u002Fgithub.com\u002Fcypress-io\u002Fai-toolkit\u002Ftree\u002FHEAD\u002Fskills\u002Fcypress-cloud-cli","---\nname: cypress-cloud-cli\ndescription: Runs the cy-cloud CLI to inspect Cypress Cloud organizations, projects, runs, specs, tests, failure screenshots, and Test Replay data. Use when the user mentions Cypress Cloud, cy-cloud, cypress-cloud-cli, a Cloud run or test URL, failing or flaky Cypress tests, Test Replay, run triage, Cloud artifacts, or asks why a recorded test failed.\nmetadata:\n  version: 1.0.0\n---\n\n# Cypress Cloud CLI\n\nUse `cy-cloud` directly to investigate Cypress Cloud. Execute the commands, inspect their JSON, and\nreport conclusions supported by the returned data. Do not send the user to the Cloud UI when the CLI\ncan answer the question.\n\n## Start safely\n\nThe published binary requires Node.js 22.21.0 or newer.\n\nRun these checks only on first use, when the environment is unknown, or after an installation or\nauthentication error. If `cy-cloud` already worked in this session, invoke the investigation command\ndirectly instead of spending another turn rechecking the setup.\n\n```bash\nnode --version\ncy-cloud status\ncy-cloud --help\n```\n\nAssume `cy-cloud` is already installed and available on `PATH`. Run it from the user's current\nworkspace; do not locate, clone, build, or depend on the cloud-cli source repository. If the command\nis unavailable, stop and report the missing prerequisite. The user can install it with:\n\n```bash\nnpm install -g @cypress\u002Fcloud\n```\n\nIf unauthenticated, ask the user to choose an authentication method:\n\n```bash\ncy-cloud login                 # interactive OAuth\ncy-cloud login --token \"$PAT\"  # persist a Personal Access Token\n```\n\nFor CI or an existing environment, `CYPRESS_CLOUD_TOKEN` takes precedence over stored credentials\nand writes no credential file.\n\nNever print, echo, read back, or commit tokens. Never inspect\n`~\u002F.config\u002Fcy-cloud\u002Fauth.json` or `cypress.env.json`; use `cy-cloud status`.\n\nThe organization must have the Cypress Cloud CLI integration enabled. A response saying it is not\nenabled requires action from an organization administrator; it cannot be fixed with another CLI command.\n\n## Discover instead of guessing\n\nEvery command supports:\n\n```bash\ncy-cloud --help\ncy-cloud \u003Ccommand> --help\ncy-cloud \u003Ccommand> --schema\n```\n\nTreat `cy-cloud --help` as authoritative for available commands, per-command `--help` as\nauthoritative for arguments, and `--schema` as the intended response contract. Use them before\nconstructing a query when a command, flag, or field is uncertain. Do not memorize a command\ninventory from this skill; the installed CLI may be newer or older than these instructions.\nValidate the actual response too: `run get` can return a fractional `duration`, and\n`replay info.failedAt` can be a fractional epoch even when the schema declares an integer. Treat\nthose values as numbers and report the schema mismatch if it matters; do not discard or round the\ndata.\n\nSuccessful data commands write JSON to stdout. Parse that JSON directly; do not install a JSON\ntool to run this skill. Replay download progress is written to stderr, so never combine stderr with\nstdout before parsing JSON:\n\n```bash\ncy-cloud replay timeline --testId \u003Cuuid> --attempt \u003CfailedAttemptNumber> 2>\u002Fdev\u002Fnull\n```\n\nIf a command fails, rerun without suppressing stderr. Argument-validation errors can appear on\nstdout; command execution errors appear on stderr. Both exit with status 1.\n\nCloud-backed fetches may be blocked by security sandboxes even when local commands such as `status`\nsucceed. Run Cloud data commands with network access allowed. If a fetch fails with a sandbox or\nnetwork denial, retry that same command with broader network permission before diagnosing a CLI,\nauthentication, or Cloud problem.\n\nReplay downloads are cached on disk. Confirm the location with `cy-cloud cache info` (`.location`)\nand run Cloud commands so that directory can be written and still exists later in this session. An\nephemeral sandbox that cannot persist it will re-download replay data or fail cache validation,\nincluding on otherwise local commands. Do not relocate the cache into the user's project.\n\nCloud API calls are rate limited per user. Prefer considered, methodical requests: reuse\nidentifiers already in a URL or prior response, skip org and project discovery when an ID is\nknown, and do not page further than the question requires. After the first replay download for a\ntest, `replay info` and `replay timeline` run against the local cache and do not count against\nthat limit, so those follow-up queries can be chatty. If a command reports an exceeded rate\nlimit, stop issuing Cloud-backed requests and report the limit; do not retry in a tight loop.\n\n## Identifiers and pagination\n\nFor `projectId`, use the project identifier already present in a Cloud URL; both the short slug and\nthe project UUID are accepted by project\u002Frun lookups and run-scoped spec\u002Ftest lists. Do not perform\norganization and project discovery merely to replace a UUID with a slug. `runNumber` is the\nper-project run number. `specId` and `testId` are UUIDs. Attempt numbers are 1-indexed, matching\nCypress Cloud.\n\nCloud list responses have `.pagination`; request more pages when the question is not limited to the\nfirst page.\n\n## Route by task\n\nRead only the references required for the current task:\n\n- **Find orgs, projects, runs, specs, or tests, or open a Cloud URL:** read\n  [investigation.md](references\u002Finvestigation.md).\n- **Inspect attempts, flakes, or failure screenshots:** read\n  [investigation.md](references\u002Finvestigation.md).\n- **Query Test Replay:** read [investigation.md](references\u002Finvestigation.md) and\n  [test-replay.md](references\u002Ftest-replay.md).\n- **Diagnose why a recorded test failed:** read [investigation.md](references\u002Finvestigation.md),\n  [test-replay.md](references\u002Ftest-replay.md), and [diagnosis.md](references\u002Fdiagnosis.md).\n\n## Cache and common recovery\n\n```bash\ncy-cloud cache info\ncy-cloud cache cleanup\ncy-cloud cache clear\n```\n\nUse `cache cleanup` for normal maintenance. Use `cache clear` only when replay resolution appears\nstale or corrupted because it forces future replay downloads. If replay re-downloads every\ncommand, the cache directory is not persisting; retry with a sandbox that can write to the\nlocation reported by `cache info`.\n\nCommon outcomes:\n\n- Missing expected fields: inspect that command's `--schema`.\n- JSON parse failure: ensure stderr was not merged into stdout.\n- Cache validation or write errors from the sandbox: retry so the cache directory is writable\n  and persistent; do not copy the cache into the project.\n- `cy-cloud version` reporting `\"status\": \"Unknown\"` does not by itself mean the installation is\n  broken or outdated. Compare `version` and `latestVersion`; upgrade only when those values or an\n  explicit compatibility error indicate it.\n- Exceeded rate limit: stop Cloud-backed requests and report the limit; do not retry in a loop.\n  Cached replay queries are exempt once the download has succeeded.\n- Replay-specific errors: read [test-replay.md](references\u002Ftest-replay.md).\n",{"data":42,"body":45},{"name":4,"description":6,"metadata":43},{"version":44},"1.0.0",{"type":46,"children":47},"root",[48,56,71,78,83,95,149,169,199,204,267,280,309,314,320,325,402,455,460,539,544,557,578,599,605,641,654,660,665,754,760,816,843,848,921],{"type":49,"tag":50,"props":51,"children":52},"element","h1",{"id":4},[53],{"type":54,"value":55},"text","Cypress Cloud CLI",{"type":49,"tag":57,"props":58,"children":59},"p",{},[60,62,69],{"type":54,"value":61},"Use ",{"type":49,"tag":63,"props":64,"children":66},"code",{"className":65},[],[67],{"type":54,"value":68},"cy-cloud",{"type":54,"value":70}," directly to investigate Cypress Cloud. Execute the commands, inspect their JSON, and\nreport conclusions supported by the returned data. Do not send the user to the Cloud UI when the CLI\ncan answer the question.",{"type":49,"tag":72,"props":73,"children":75},"h2",{"id":74},"start-safely",[76],{"type":54,"value":77},"Start safely",{"type":49,"tag":57,"props":79,"children":80},{},[81],{"type":54,"value":82},"The published binary requires Node.js 22.21.0 or newer.",{"type":49,"tag":57,"props":84,"children":85},{},[86,88,93],{"type":54,"value":87},"Run these checks only on first use, when the environment is unknown, or after an installation or\nauthentication error. If ",{"type":49,"tag":63,"props":89,"children":91},{"className":90},[],[92],{"type":54,"value":68},{"type":54,"value":94}," already worked in this session, invoke the investigation command\ndirectly instead of spending another turn rechecking the setup.",{"type":49,"tag":96,"props":97,"children":102},"pre",{"className":98,"code":99,"language":100,"meta":101,"style":101},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","node --version\ncy-cloud status\ncy-cloud --help\n","bash","",[103],{"type":49,"tag":63,"props":104,"children":105},{"__ignoreMap":101},[106,124,137],{"type":49,"tag":107,"props":108,"children":111},"span",{"class":109,"line":110},"line",1,[112,118],{"type":49,"tag":107,"props":113,"children":115},{"style":114},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[116],{"type":54,"value":117},"node",{"type":49,"tag":107,"props":119,"children":121},{"style":120},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[122],{"type":54,"value":123}," --version\n",{"type":49,"tag":107,"props":125,"children":127},{"class":109,"line":126},2,[128,132],{"type":49,"tag":107,"props":129,"children":130},{"style":114},[131],{"type":54,"value":68},{"type":49,"tag":107,"props":133,"children":134},{"style":120},[135],{"type":54,"value":136}," status\n",{"type":49,"tag":107,"props":138,"children":139},{"class":109,"line":30},[140,144],{"type":49,"tag":107,"props":141,"children":142},{"style":114},[143],{"type":54,"value":68},{"type":49,"tag":107,"props":145,"children":146},{"style":120},[147],{"type":54,"value":148}," --help\n",{"type":49,"tag":57,"props":150,"children":151},{},[152,154,159,161,167],{"type":54,"value":153},"Assume ",{"type":49,"tag":63,"props":155,"children":157},{"className":156},[],[158],{"type":54,"value":68},{"type":54,"value":160}," is already installed and available on ",{"type":49,"tag":63,"props":162,"children":164},{"className":163},[],[165],{"type":54,"value":166},"PATH",{"type":54,"value":168},". Run it from the user's current\nworkspace; do not locate, clone, build, or depend on the cloud-cli source repository. If the command\nis unavailable, stop and report the missing prerequisite. The user can install it with:",{"type":49,"tag":96,"props":170,"children":172},{"className":98,"code":171,"language":100,"meta":101,"style":101},"npm install -g @cypress\u002Fcloud\n",[173],{"type":49,"tag":63,"props":174,"children":175},{"__ignoreMap":101},[176],{"type":49,"tag":107,"props":177,"children":178},{"class":109,"line":110},[179,184,189,194],{"type":49,"tag":107,"props":180,"children":181},{"style":114},[182],{"type":54,"value":183},"npm",{"type":49,"tag":107,"props":185,"children":186},{"style":120},[187],{"type":54,"value":188}," install",{"type":49,"tag":107,"props":190,"children":191},{"style":120},[192],{"type":54,"value":193}," -g",{"type":49,"tag":107,"props":195,"children":196},{"style":120},[197],{"type":54,"value":198}," @cypress\u002Fcloud\n",{"type":49,"tag":57,"props":200,"children":201},{},[202],{"type":54,"value":203},"If unauthenticated, ask the user to choose an authentication method:",{"type":49,"tag":96,"props":205,"children":207},{"className":98,"code":206,"language":100,"meta":101,"style":101},"cy-cloud login                 # interactive OAuth\ncy-cloud login --token \"$PAT\"  # persist a Personal Access Token\n",[208],{"type":49,"tag":63,"props":209,"children":210},{"__ignoreMap":101},[211,229],{"type":49,"tag":107,"props":212,"children":213},{"class":109,"line":110},[214,218,223],{"type":49,"tag":107,"props":215,"children":216},{"style":114},[217],{"type":54,"value":68},{"type":49,"tag":107,"props":219,"children":220},{"style":120},[221],{"type":54,"value":222}," login",{"type":49,"tag":107,"props":224,"children":226},{"style":225},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[227],{"type":54,"value":228},"                 # interactive OAuth\n",{"type":49,"tag":107,"props":230,"children":231},{"class":109,"line":126},[232,236,240,245,251,257,262],{"type":49,"tag":107,"props":233,"children":234},{"style":114},[235],{"type":54,"value":68},{"type":49,"tag":107,"props":237,"children":238},{"style":120},[239],{"type":54,"value":222},{"type":49,"tag":107,"props":241,"children":242},{"style":120},[243],{"type":54,"value":244}," --token",{"type":49,"tag":107,"props":246,"children":248},{"style":247},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[249],{"type":54,"value":250}," \"",{"type":49,"tag":107,"props":252,"children":254},{"style":253},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[255],{"type":54,"value":256},"$PAT",{"type":49,"tag":107,"props":258,"children":259},{"style":247},[260],{"type":54,"value":261},"\"",{"type":49,"tag":107,"props":263,"children":264},{"style":225},[265],{"type":54,"value":266},"  # persist a Personal Access Token\n",{"type":49,"tag":57,"props":268,"children":269},{},[270,272,278],{"type":54,"value":271},"For CI or an existing environment, ",{"type":49,"tag":63,"props":273,"children":275},{"className":274},[],[276],{"type":54,"value":277},"CYPRESS_CLOUD_TOKEN",{"type":54,"value":279}," takes precedence over stored credentials\nand writes no credential file.",{"type":49,"tag":57,"props":281,"children":282},{},[283,285,291,293,299,301,307],{"type":54,"value":284},"Never print, echo, read back, or commit tokens. Never inspect\n",{"type":49,"tag":63,"props":286,"children":288},{"className":287},[],[289],{"type":54,"value":290},"~\u002F.config\u002Fcy-cloud\u002Fauth.json",{"type":54,"value":292}," or ",{"type":49,"tag":63,"props":294,"children":296},{"className":295},[],[297],{"type":54,"value":298},"cypress.env.json",{"type":54,"value":300},"; use ",{"type":49,"tag":63,"props":302,"children":304},{"className":303},[],[305],{"type":54,"value":306},"cy-cloud status",{"type":54,"value":308},".",{"type":49,"tag":57,"props":310,"children":311},{},[312],{"type":54,"value":313},"The organization must have the Cypress Cloud CLI integration enabled. A response saying it is not\nenabled requires action from an organization administrator; it cannot be fixed with another CLI command.",{"type":49,"tag":72,"props":315,"children":317},{"id":316},"discover-instead-of-guessing",[318],{"type":54,"value":319},"Discover instead of guessing",{"type":49,"tag":57,"props":321,"children":322},{},[323],{"type":54,"value":324},"Every command supports:",{"type":49,"tag":96,"props":326,"children":328},{"className":98,"code":327,"language":100,"meta":101,"style":101},"cy-cloud --help\ncy-cloud \u003Ccommand> --help\ncy-cloud \u003Ccommand> --schema\n",[329],{"type":49,"tag":63,"props":330,"children":331},{"__ignoreMap":101},[332,343,374],{"type":49,"tag":107,"props":333,"children":334},{"class":109,"line":110},[335,339],{"type":49,"tag":107,"props":336,"children":337},{"style":114},[338],{"type":54,"value":68},{"type":49,"tag":107,"props":340,"children":341},{"style":120},[342],{"type":54,"value":148},{"type":49,"tag":107,"props":344,"children":345},{"class":109,"line":126},[346,350,355,360,365,370],{"type":49,"tag":107,"props":347,"children":348},{"style":114},[349],{"type":54,"value":68},{"type":49,"tag":107,"props":351,"children":352},{"style":247},[353],{"type":54,"value":354}," \u003C",{"type":49,"tag":107,"props":356,"children":357},{"style":120},[358],{"type":54,"value":359},"comman",{"type":49,"tag":107,"props":361,"children":362},{"style":253},[363],{"type":54,"value":364},"d",{"type":49,"tag":107,"props":366,"children":367},{"style":247},[368],{"type":54,"value":369},">",{"type":49,"tag":107,"props":371,"children":372},{"style":120},[373],{"type":54,"value":148},{"type":49,"tag":107,"props":375,"children":376},{"class":109,"line":30},[377,381,385,389,393,397],{"type":49,"tag":107,"props":378,"children":379},{"style":114},[380],{"type":54,"value":68},{"type":49,"tag":107,"props":382,"children":383},{"style":247},[384],{"type":54,"value":354},{"type":49,"tag":107,"props":386,"children":387},{"style":120},[388],{"type":54,"value":359},{"type":49,"tag":107,"props":390,"children":391},{"style":253},[392],{"type":54,"value":364},{"type":49,"tag":107,"props":394,"children":395},{"style":247},[396],{"type":54,"value":369},{"type":49,"tag":107,"props":398,"children":399},{"style":120},[400],{"type":54,"value":401}," --schema\n",{"type":49,"tag":57,"props":403,"children":404},{},[405,407,413,415,421,423,429,431,437,439,445,447,453],{"type":54,"value":406},"Treat ",{"type":49,"tag":63,"props":408,"children":410},{"className":409},[],[411],{"type":54,"value":412},"cy-cloud --help",{"type":54,"value":414}," as authoritative for available commands, per-command ",{"type":49,"tag":63,"props":416,"children":418},{"className":417},[],[419],{"type":54,"value":420},"--help",{"type":54,"value":422}," as\nauthoritative for arguments, and ",{"type":49,"tag":63,"props":424,"children":426},{"className":425},[],[427],{"type":54,"value":428},"--schema",{"type":54,"value":430}," as the intended response contract. Use them before\nconstructing a query when a command, flag, or field is uncertain. Do not memorize a command\ninventory from this skill; the installed CLI may be newer or older than these instructions.\nValidate the actual response too: ",{"type":49,"tag":63,"props":432,"children":434},{"className":433},[],[435],{"type":54,"value":436},"run get",{"type":54,"value":438}," can return a fractional ",{"type":49,"tag":63,"props":440,"children":442},{"className":441},[],[443],{"type":54,"value":444},"duration",{"type":54,"value":446},", and\n",{"type":49,"tag":63,"props":448,"children":450},{"className":449},[],[451],{"type":54,"value":452},"replay info.failedAt",{"type":54,"value":454}," can be a fractional epoch even when the schema declares an integer. Treat\nthose values as numbers and report the schema mismatch if it matters; do not discard or round the\ndata.",{"type":49,"tag":57,"props":456,"children":457},{},[458],{"type":54,"value":459},"Successful data commands write JSON to stdout. Parse that JSON directly; do not install a JSON\ntool to run this skill. Replay download progress is written to stderr, so never combine stderr with\nstdout before parsing JSON:",{"type":49,"tag":96,"props":461,"children":463},{"className":98,"code":462,"language":100,"meta":101,"style":101},"cy-cloud replay timeline --testId \u003Cuuid> --attempt \u003CfailedAttemptNumber> 2>\u002Fdev\u002Fnull\n",[464],{"type":49,"tag":63,"props":465,"children":466},{"__ignoreMap":101},[467],{"type":49,"tag":107,"props":468,"children":469},{"class":109,"line":110},[470,474,479,484,489,493,498,502,506,511,515,520,525,529,534],{"type":49,"tag":107,"props":471,"children":472},{"style":114},[473],{"type":54,"value":68},{"type":49,"tag":107,"props":475,"children":476},{"style":120},[477],{"type":54,"value":478}," replay",{"type":49,"tag":107,"props":480,"children":481},{"style":120},[482],{"type":54,"value":483}," timeline",{"type":49,"tag":107,"props":485,"children":486},{"style":120},[487],{"type":54,"value":488}," --testId",{"type":49,"tag":107,"props":490,"children":491},{"style":247},[492],{"type":54,"value":354},{"type":49,"tag":107,"props":494,"children":495},{"style":120},[496],{"type":54,"value":497},"uui",{"type":49,"tag":107,"props":499,"children":500},{"style":253},[501],{"type":54,"value":364},{"type":49,"tag":107,"props":503,"children":504},{"style":247},[505],{"type":54,"value":369},{"type":49,"tag":107,"props":507,"children":508},{"style":120},[509],{"type":54,"value":510}," --attempt",{"type":49,"tag":107,"props":512,"children":513},{"style":247},[514],{"type":54,"value":354},{"type":49,"tag":107,"props":516,"children":517},{"style":120},[518],{"type":54,"value":519},"failedAttemptNumbe",{"type":49,"tag":107,"props":521,"children":522},{"style":253},[523],{"type":54,"value":524},"r",{"type":49,"tag":107,"props":526,"children":527},{"style":247},[528],{"type":54,"value":369},{"type":49,"tag":107,"props":530,"children":531},{"style":247},[532],{"type":54,"value":533}," 2>",{"type":49,"tag":107,"props":535,"children":536},{"style":120},[537],{"type":54,"value":538},"\u002Fdev\u002Fnull\n",{"type":49,"tag":57,"props":540,"children":541},{},[542],{"type":54,"value":543},"If a command fails, rerun without suppressing stderr. Argument-validation errors can appear on\nstdout; command execution errors appear on stderr. Both exit with status 1.",{"type":49,"tag":57,"props":545,"children":546},{},[547,549,555],{"type":54,"value":548},"Cloud-backed fetches may be blocked by security sandboxes even when local commands such as ",{"type":49,"tag":63,"props":550,"children":552},{"className":551},[],[553],{"type":54,"value":554},"status",{"type":54,"value":556},"\nsucceed. Run Cloud data commands with network access allowed. If a fetch fails with a sandbox or\nnetwork denial, retry that same command with broader network permission before diagnosing a CLI,\nauthentication, or Cloud problem.",{"type":49,"tag":57,"props":558,"children":559},{},[560,562,568,570,576],{"type":54,"value":561},"Replay downloads are cached on disk. Confirm the location with ",{"type":49,"tag":63,"props":563,"children":565},{"className":564},[],[566],{"type":54,"value":567},"cy-cloud cache info",{"type":54,"value":569}," (",{"type":49,"tag":63,"props":571,"children":573},{"className":572},[],[574],{"type":54,"value":575},".location",{"type":54,"value":577},")\nand run Cloud commands so that directory can be written and still exists later in this session. An\nephemeral sandbox that cannot persist it will re-download replay data or fail cache validation,\nincluding on otherwise local commands. Do not relocate the cache into the user's project.",{"type":49,"tag":57,"props":579,"children":580},{},[581,583,589,591,597],{"type":54,"value":582},"Cloud API calls are rate limited per user. Prefer considered, methodical requests: reuse\nidentifiers already in a URL or prior response, skip org and project discovery when an ID is\nknown, and do not page further than the question requires. After the first replay download for a\ntest, ",{"type":49,"tag":63,"props":584,"children":586},{"className":585},[],[587],{"type":54,"value":588},"replay info",{"type":54,"value":590}," and ",{"type":49,"tag":63,"props":592,"children":594},{"className":593},[],[595],{"type":54,"value":596},"replay timeline",{"type":54,"value":598}," run against the local cache and do not count against\nthat limit, so those follow-up queries can be chatty. If a command reports an exceeded rate\nlimit, stop issuing Cloud-backed requests and report the limit; do not retry in a tight loop.",{"type":49,"tag":72,"props":600,"children":602},{"id":601},"identifiers-and-pagination",[603],{"type":54,"value":604},"Identifiers and pagination",{"type":49,"tag":57,"props":606,"children":607},{},[608,610,616,618,624,626,632,633,639],{"type":54,"value":609},"For ",{"type":49,"tag":63,"props":611,"children":613},{"className":612},[],[614],{"type":54,"value":615},"projectId",{"type":54,"value":617},", use the project identifier already present in a Cloud URL; both the short slug and\nthe project UUID are accepted by project\u002Frun lookups and run-scoped spec\u002Ftest lists. Do not perform\norganization and project discovery merely to replace a UUID with a slug. ",{"type":49,"tag":63,"props":619,"children":621},{"className":620},[],[622],{"type":54,"value":623},"runNumber",{"type":54,"value":625}," is the\nper-project run number. ",{"type":49,"tag":63,"props":627,"children":629},{"className":628},[],[630],{"type":54,"value":631},"specId",{"type":54,"value":590},{"type":49,"tag":63,"props":634,"children":636},{"className":635},[],[637],{"type":54,"value":638},"testId",{"type":54,"value":640}," are UUIDs. Attempt numbers are 1-indexed, matching\nCypress Cloud.",{"type":49,"tag":57,"props":642,"children":643},{},[644,646,652],{"type":54,"value":645},"Cloud list responses have ",{"type":49,"tag":63,"props":647,"children":649},{"className":648},[],[650],{"type":54,"value":651},".pagination",{"type":54,"value":653},"; request more pages when the question is not limited to the\nfirst page.",{"type":49,"tag":72,"props":655,"children":657},{"id":656},"route-by-task",[658],{"type":54,"value":659},"Route by task",{"type":49,"tag":57,"props":661,"children":662},{},[663],{"type":54,"value":664},"Read only the references required for the current task:",{"type":49,"tag":666,"props":667,"children":668},"ul",{},[669,689,703,726],{"type":49,"tag":670,"props":671,"children":672},"li",{},[673,679,681,688],{"type":49,"tag":674,"props":675,"children":676},"strong",{},[677],{"type":54,"value":678},"Find orgs, projects, runs, specs, or tests, or open a Cloud URL:",{"type":54,"value":680}," read\n",{"type":49,"tag":682,"props":683,"children":685},"a",{"href":684},"references\u002Finvestigation.md",[686],{"type":54,"value":687},"investigation.md",{"type":54,"value":308},{"type":49,"tag":670,"props":690,"children":691},{},[692,697,698,702],{"type":49,"tag":674,"props":693,"children":694},{},[695],{"type":54,"value":696},"Inspect attempts, flakes, or failure screenshots:",{"type":54,"value":680},{"type":49,"tag":682,"props":699,"children":700},{"href":684},[701],{"type":54,"value":687},{"type":54,"value":308},{"type":49,"tag":670,"props":704,"children":705},{},[706,711,713,717,719,725],{"type":49,"tag":674,"props":707,"children":708},{},[709],{"type":54,"value":710},"Query Test Replay:",{"type":54,"value":712}," read ",{"type":49,"tag":682,"props":714,"children":715},{"href":684},[716],{"type":54,"value":687},{"type":54,"value":718}," and\n",{"type":49,"tag":682,"props":720,"children":722},{"href":721},"references\u002Ftest-replay.md",[723],{"type":54,"value":724},"test-replay.md",{"type":54,"value":308},{"type":49,"tag":670,"props":727,"children":728},{},[729,734,735,739,741,745,747,753],{"type":49,"tag":674,"props":730,"children":731},{},[732],{"type":54,"value":733},"Diagnose why a recorded test failed:",{"type":54,"value":712},{"type":49,"tag":682,"props":736,"children":737},{"href":684},[738],{"type":54,"value":687},{"type":54,"value":740},",\n",{"type":49,"tag":682,"props":742,"children":743},{"href":721},[744],{"type":54,"value":724},{"type":54,"value":746},", and ",{"type":49,"tag":682,"props":748,"children":750},{"href":749},"references\u002Fdiagnosis.md",[751],{"type":54,"value":752},"diagnosis.md",{"type":54,"value":308},{"type":49,"tag":72,"props":755,"children":757},{"id":756},"cache-and-common-recovery",[758],{"type":54,"value":759},"Cache and common recovery",{"type":49,"tag":96,"props":761,"children":763},{"className":98,"code":762,"language":100,"meta":101,"style":101},"cy-cloud cache info\ncy-cloud cache cleanup\ncy-cloud cache clear\n",[764],{"type":49,"tag":63,"props":765,"children":766},{"__ignoreMap":101},[767,784,800],{"type":49,"tag":107,"props":768,"children":769},{"class":109,"line":110},[770,774,779],{"type":49,"tag":107,"props":771,"children":772},{"style":114},[773],{"type":54,"value":68},{"type":49,"tag":107,"props":775,"children":776},{"style":120},[777],{"type":54,"value":778}," cache",{"type":49,"tag":107,"props":780,"children":781},{"style":120},[782],{"type":54,"value":783}," info\n",{"type":49,"tag":107,"props":785,"children":786},{"class":109,"line":126},[787,791,795],{"type":49,"tag":107,"props":788,"children":789},{"style":114},[790],{"type":54,"value":68},{"type":49,"tag":107,"props":792,"children":793},{"style":120},[794],{"type":54,"value":778},{"type":49,"tag":107,"props":796,"children":797},{"style":120},[798],{"type":54,"value":799}," cleanup\n",{"type":49,"tag":107,"props":801,"children":802},{"class":109,"line":30},[803,807,811],{"type":49,"tag":107,"props":804,"children":805},{"style":114},[806],{"type":54,"value":68},{"type":49,"tag":107,"props":808,"children":809},{"style":120},[810],{"type":54,"value":778},{"type":49,"tag":107,"props":812,"children":813},{"style":120},[814],{"type":54,"value":815}," clear\n",{"type":49,"tag":57,"props":817,"children":818},{},[819,820,826,828,834,836,842],{"type":54,"value":61},{"type":49,"tag":63,"props":821,"children":823},{"className":822},[],[824],{"type":54,"value":825},"cache cleanup",{"type":54,"value":827}," for normal maintenance. Use ",{"type":49,"tag":63,"props":829,"children":831},{"className":830},[],[832],{"type":54,"value":833},"cache clear",{"type":54,"value":835}," only when replay resolution appears\nstale or corrupted because it forces future replay downloads. If replay re-downloads every\ncommand, the cache directory is not persisting; retry with a sandbox that can write to the\nlocation reported by ",{"type":49,"tag":63,"props":837,"children":839},{"className":838},[],[840],{"type":54,"value":841},"cache info",{"type":54,"value":308},{"type":49,"tag":57,"props":844,"children":845},{},[846],{"type":54,"value":847},"Common outcomes:",{"type":49,"tag":666,"props":849,"children":850},{},[851,862,867,872,906,911],{"type":49,"tag":670,"props":852,"children":853},{},[854,856,861],{"type":54,"value":855},"Missing expected fields: inspect that command's ",{"type":49,"tag":63,"props":857,"children":859},{"className":858},[],[860],{"type":54,"value":428},{"type":54,"value":308},{"type":49,"tag":670,"props":863,"children":864},{},[865],{"type":54,"value":866},"JSON parse failure: ensure stderr was not merged into stdout.",{"type":49,"tag":670,"props":868,"children":869},{},[870],{"type":54,"value":871},"Cache validation or write errors from the sandbox: retry so the cache directory is writable\nand persistent; do not copy the cache into the project.",{"type":49,"tag":670,"props":873,"children":874},{},[875,881,883,889,891,897,898,904],{"type":49,"tag":63,"props":876,"children":878},{"className":877},[],[879],{"type":54,"value":880},"cy-cloud version",{"type":54,"value":882}," reporting ",{"type":49,"tag":63,"props":884,"children":886},{"className":885},[],[887],{"type":54,"value":888},"\"status\": \"Unknown\"",{"type":54,"value":890}," does not by itself mean the installation is\nbroken or outdated. Compare ",{"type":49,"tag":63,"props":892,"children":894},{"className":893},[],[895],{"type":54,"value":896},"version",{"type":54,"value":590},{"type":49,"tag":63,"props":899,"children":901},{"className":900},[],[902],{"type":54,"value":903},"latestVersion",{"type":54,"value":905},"; upgrade only when those values or an\nexplicit compatibility error indicate it.",{"type":49,"tag":670,"props":907,"children":908},{},[909],{"type":54,"value":910},"Exceeded rate limit: stop Cloud-backed requests and report the limit; do not retry in a loop.\nCached replay queries are exempt once the download has succeeded.",{"type":49,"tag":670,"props":912,"children":913},{},[914,916,920],{"type":54,"value":915},"Replay-specific errors: read ",{"type":49,"tag":682,"props":917,"children":918},{"href":721},[919],{"type":54,"value":724},{"type":54,"value":308},{"type":49,"tag":922,"props":923,"children":924},"style",{},[925],{"type":54,"value":926},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":928,"total":993},[929,947,954,969,982],{"slug":930,"name":930,"fn":931,"description":932,"org":933,"tags":934,"stars":26,"repoUrl":27,"updatedAt":946},"cypress-author","create and fix Cypress tests","Creates, updates, and fixes Cypress tests (E2E\u002Fend-to-end and component tests). Use when the user asks to create tests, add tests, write tests, update tests, test this file\u002Fcomponent, new spec, or fix a failing or flaky test. Apply even when the user does not say 'Cypress' (e.g. 'create tests for this file'). Prefer cypress-explain when the user only wants to explain or review tests without changing code.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[935,936,939,942,945],{"name":9,"slug":8,"type":16},{"name":937,"slug":938,"type":16},"E2E Testing","e2e-testing",{"name":940,"slug":941,"type":16},"Engineering","engineering",{"name":943,"slug":944,"type":16},"QA","qa",{"name":21,"slug":22,"type":16},"2026-07-12T07:58:26.471244",{"slug":4,"name":4,"fn":5,"description":6,"org":948,"tags":949,"stars":26,"repoUrl":27,"updatedAt":28},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[950,951,952,953],{"name":18,"slug":19,"type":16},{"name":24,"slug":25,"type":16},{"name":14,"slug":15,"type":16},{"name":21,"slug":22,"type":16},{"slug":955,"name":955,"fn":956,"description":957,"org":958,"tags":959,"stars":26,"repoUrl":27,"updatedAt":968},"cypress-docs","retrieve Cypress documentation and references","Search and extract Cypress information from official documentation (docs.cypress.io, cypress.io); prefer LLM markdown under \u002Fllm\u002F* and refuse unverified API or behavior claims.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[960,961,964,967],{"name":9,"slug":8,"type":16},{"name":962,"slug":963,"type":16},"Documentation","documentation",{"name":965,"slug":966,"type":16},"Search","search",{"name":21,"slug":22,"type":16},"2026-07-12T07:58:24.963932",{"slug":970,"name":970,"fn":971,"description":972,"org":973,"tags":974,"stars":26,"repoUrl":27,"updatedAt":981},"cypress-explain","explain and review Cypress tests","Explains Cypress tests (E2E and component tests), and answers questions about Cypress use and behavior. Use when the user asks to explain how a test works, explain how Cypress works, review or critique a test without writing code. Apply even when the user does not say 'Cypress' (e.g. 'explain this test'). Prefer the cypress-author skill when the user wants to create, fix, or update tests.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[975,978,979,980],{"name":976,"slug":977,"type":16},"Code Review","code-review",{"name":9,"slug":8,"type":16},{"name":24,"slug":25,"type":16},{"name":21,"slug":22,"type":16},"2026-07-12T07:58:27.858171",{"slug":983,"name":983,"fn":984,"description":985,"org":986,"tags":987,"stars":26,"repoUrl":27,"updatedAt":992},"cypress-tap","drive and inspect Cypress test sessions","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.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[988,989,990,991],{"name":9,"slug":8,"type":16},{"name":24,"slug":25,"type":16},{"name":937,"slug":938,"type":16},{"name":21,"slug":22,"type":16},"2026-08-26T04:11:18.490315",5,{"items":995,"total":993},[996,1004,1011,1018,1025],{"slug":930,"name":930,"fn":931,"description":932,"org":997,"tags":998,"stars":26,"repoUrl":27,"updatedAt":946},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[999,1000,1001,1002,1003],{"name":9,"slug":8,"type":16},{"name":937,"slug":938,"type":16},{"name":940,"slug":941,"type":16},{"name":943,"slug":944,"type":16},{"name":21,"slug":22,"type":16},{"slug":4,"name":4,"fn":5,"description":6,"org":1005,"tags":1006,"stars":26,"repoUrl":27,"updatedAt":28},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1007,1008,1009,1010],{"name":18,"slug":19,"type":16},{"name":24,"slug":25,"type":16},{"name":14,"slug":15,"type":16},{"name":21,"slug":22,"type":16},{"slug":955,"name":955,"fn":956,"description":957,"org":1012,"tags":1013,"stars":26,"repoUrl":27,"updatedAt":968},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1014,1015,1016,1017],{"name":9,"slug":8,"type":16},{"name":962,"slug":963,"type":16},{"name":965,"slug":966,"type":16},{"name":21,"slug":22,"type":16},{"slug":970,"name":970,"fn":971,"description":972,"org":1019,"tags":1020,"stars":26,"repoUrl":27,"updatedAt":981},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1021,1022,1023,1024],{"name":976,"slug":977,"type":16},{"name":9,"slug":8,"type":16},{"name":24,"slug":25,"type":16},{"name":21,"slug":22,"type":16},{"slug":983,"name":983,"fn":984,"description":985,"org":1026,"tags":1027,"stars":26,"repoUrl":27,"updatedAt":992},{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[1028,1029,1030,1031],{"name":9,"slug":8,"type":16},{"name":24,"slug":25,"type":16},{"name":937,"slug":938,"type":16},{"name":21,"slug":22,"type":16}]