feat: --posix-exit-codes cli flag in run mode

[cacieprins]

• Closes --posix-exit-codes flag for run/record mode #32605
• Closes Exit codes for cli #24695

Additional details

Steps to test

As in the added system test, cypress run --posix-exit-codes against a spec with multiple test failures; assert that the exit code is 1 rather than the number of tests that fail.

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? docs: adds --posix-exit-codes cli flag for run mode cypress-documentation#6284
• Have API changes been updated in the type definitions?

---

Note

Adds --posix-exit-codes to cypress run and plumbs it through CLI, server, and types so runs exit 1 on any failures (0 on success), with tests and changelog updates.

• CLI:
  • Add --posix-exit-codes flag and help text in cli/lib/cli.ts and plumb option via cli/lib/exec/run.ts and cli/lib/util.ts (posixExitCodes).
• Server:
  • In packages/server/lib/cypress.ts, if options.posixExitCodes is set, exit 1 when results.totalFailed > 0, else 0.
  • Wire CLI arg in packages/server/lib/util/args.js (allow list + alias for posix-exit-codes).
• Types:
  • Add posixExitCodes to cli/types/cypress-npm-api.d.ts and packages/types/src/modeOptions.ts.
• Tests:
  • Unit tests for CLI option and arg propagation; update snapshots.
  • System tests system-tests/test/posix_exit_codes_spec.ts validating exit codes; add pass-through in system-tests/lib/system-tests.ts.
• Docs/Changelog:
  • Update cli/CHANGELOG.md with new feature entry.

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

[cypress]

cypress    Run #66029

Run Properties:   Passed #66029  •  4696ca3637: Apply suggestion from @jennifer-shehane

Project	cypress
Branch Review	feat-32605-posix-exit-codes
Run status	Passed #66029
Run duration	09m 04s
Commit	4696ca3637: Apply suggestion from @jennifer-shehane
Committer	Cacie Prins
View all properties for this run ↗︎

---

Test results
Failures	0
Flaky	0
Pending	694
Skipped	0
Passing	130
View all changes introduced in this branch ↗︎

[jennifer-shehane]

@cacieprins I'm not sure how to mention this, but this also fixes a bug where if you opt into this - then tests with a number of failures that are a multiple of 256 will now properly send an exit code that will fail instead of exitCode=0. Maybe another line item in the bugfixes????

[cacieprins]

@cacieprins I'm not sure how to mention this, but this also fixes a bug where if you opt into this - then tests with a number of failures that are a multiple of 256 will now properly send an exit code that will fail instead of exitCode=0. Maybe another line item in the bugfixes????

Makes sense! posix exit codes are generally 8 bits; most shells handle exit codes >255 as modulo 256.

[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.