# What changed in @wdio/cli

> 35 changes in @wdio/cli 9 to 10 from its official release notes, upgrade guides and advisories: 8 breaking, 3 new APIs and options. Each one cited. Sources checked 2026-10-18. HTML: https://unstale.sh/npm/@wdio/cli/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @wdio/cli 10

### Breaking changes

- Appium 3 is required, and Appium 1/2 HTTP fallbacks are dropped. (10.0.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v1000-2026-10-05)
- Unprefixed capability specs and exclude are dropped; use the prefixed capability configuration instead. (10.0.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v1000-2026-10-05)
- The Cucumber framework upgrades @cucumber/cucumber to 13, which may require adapting existing framework usage. (10.0.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v1000-2026-10-05)
- Deprecated config globals and reporter APIs are removed, so configurations relying on them need updating. (10.0.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v1000-2026-10-05)
- Remaining JSON Wire Protocol leftovers are dropped; legacy protocol configuration and usage are no longer supported. (10.0.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v1000-2026-10-05)
- JSONWP Appium capabilities and the mobile getValue fallback are dropped. (10.0.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v1000-2026-10-05)
- Multiremote naming is aligned to multi-remote / multiRemote, requiring updates to older naming. (10.0.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v1000-2026-10-05)
- The minimum supported Node.js version is 22.19.0. (10.0.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v1000-2026-10-05)

### Performance

- Testrunner hot paths were optimized, with gains measured in the mock benchmark. (10.0.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v1000-2026-10-05)

## @wdio/cli 9

### New APIs and options

- Supports using CHROMEDRIVER_CDNURL to configure custom ChromeDriver mirrors. (9.31.9) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9319-2026-09-13)
- BrowserStack service adds one-to-many Test-Case-ID tagging. (9.29.1) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9291-2026-06-26)
- Allows --exclude to exclude suites by name. (9.23.1) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9231-2026-01-18)

### Performance

- Improves selector performance in the Appium service. (9.24.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9240-2026-02-10)

### Tooling

- Added support for CPU and heap profiling. (9.32.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9320-2026-09-20)

### Fixes and other changes

- Signal-terminated workers now cause the CLI to report a non-zero exit code. (9.32.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9320-2026-09-20)
- Fixes EdgeDriver upgrade accounting when the browser version is missing a corresponding driver architecture. (9.31.9) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9319-2026-09-13)
- Restores nested and Shadow DOM scrolling in scrollIntoView. (9.31.8) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9318-2026-09-12)
- The WebDriver Bidi response timeout is configurable, allowing developers to adjust the timeout. (9.30.1) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9301-2026-08-03)
- BrowserStack routes App Automate sessions from the WDIO CLI flow to app-accessibility. (9.30.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9300-2026-07-21)
- BrowserStack service skips accessibility scans for BiDi window and context commands. (9.30.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9300-2026-07-21)
- BrowserStack service finalizes orphaned test runs when the process exits interrupted. (9.30.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9300-2026-07-21)
- BrowserStack service now reports Mocha hooks in the CLI/testhub flow. (9.30.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9300-2026-07-21)
- BiDi skips the isConnected check for non-shadow element scopes. (9.29.1) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9291-2026-06-26)
- Fixes the logger’s CommonJS compliance, improving compatibility for developers using it from CommonJS code. (9.28.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9280-2026-06-10)
- Fixes mobile command argument mismatches for Appium 3 compatibility. (9.26.1) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9261-2026-03-15)
- Log file prefixes now include the spec file name. (9.23.3) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9233-2026-02-01)
- Fixes handling of dynamic specs added in onPrepare. (9.23.1) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9231-2026-01-18)
- Allows specFileRetries to be overridden in the beforeSession hook. (9.23.1) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9231-2026-01-18)
- Fixes which files are watched by the watcher. (9.23.1) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9231-2026-01-18)
- Fixes an issue that caused the CLI to load the config file twice. (9.22.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9220-2025-12-24)
- Corrects the parallel multiremote check when capabilities are empty. (9.22.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9220-2025-12-24)
- Fixes an issue with the timing of TSX file loading in the CLI. (9.22.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9220-2025-12-24)
- The CLI now respects maxInstancesPerCapability for dynamic capabilities. (9.21.0) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9210-2025-11-29)
- The tsConfigPath setting in wdio.conf was reverted. (9.20.1) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9201-2025-11-18)
- Fixed wdio repl when run with multiremote capabilities. (9.20.1) — [release notes](https://github.com/webdriverio/webdriverio/blob/f256375e1426e3607ae9a539ffc1117191b0d097/CHANGELOG.md#v9201-2025-11-18)