Skip to content

Changelog: VIP-CLI

VIP-CLI is regularly updated and the current release version can be installed with the VIP-CLI package manager. Update the version of VIP-CLI that is installed on a user's local machine with the command: npm install -g @automattic/vip

RSS 

Showing page 2 of 2

25 November 2025

18:00:06 GMT+0000

v3.22.0

VIP-CLI
GitHub
Permalink

Added

  • Added isLocalArchive helper to validate local archive files (.tar.gz, .tgz, .zip).
  • vip import media now accepts a local archive path; local files are uploaded and then imported via presigned URL.
  • Added unit tests for isLocalArchive.
  • Added a help/example entry for local-archive usage.
  • Parsing of multiline values for the vip wp command
  • Experimental support for PHP 8.5 to Dev Environments.

Changed

  • Updated vip import media behavior to validate both URL and local archive inputs and present clearer error messages for each failure mode.
12 November 2025

20:32:20 GMT+0000

v3.21.2

VIP-CLI
GitHub
Permalink

Changed

  • Modified the help menu descriptions and examples for the vip dev-env envvar subcommand group.
  • Local Dev Env: Elasticsearch container memory is capped at 1GB now

Fixed

  • vip dev-env envvar commands now correctly display values with embedded equal signs.
  • vip dev-env sync sql now supports networks with more than 500 sites.
12 November 2025

20:29:08 GMT+0000

v3.21.1

VIP-CLI
GitHub
Permalink

Changed

  • Updated the wording and examples for the new options related to importing SQL database files from a remote URL.
  • Improve error handling for WPCloud WP-CLI commands

Fixed

  • Prompt display in the vip wp command

10 September 2025

20:48:08 GMT+0000

v3.21.0

VIP-CLI
GitHub
Permalink

Changed

  • Partial Database Export (vip export sql) argument changed from --subsite-id to --site-id
29 August 2025

21:11:00 GMT+0000

v3.20.4

VIP-CLI
Permalink

Changed

  • New develop release: 3.20.4-dev.0 by @github-actions[bot] in #2529
  • fix: version check for Node.js compatibility by @sjinks in #2531
  • New package release: v3.20.4 by @github-actions[bot] in #2532

Full Changelog: 3.20.3…3.20.4

28 August 2025

21:11:00 GMT+0000

v3.20.3

VIP-CLI
Permalink

Changed

  • New develop release: 3.20.3-dev.0 by @github-actions[bot] in #2526
  • build(deps-dev): bump the testing group with 3 updates by @dependabot[bot] in #2519
  • chore: update Node.js version requirements by @sjinks in #2527
  • chore(deps): update lando to use new lando-util image by @sjinks in #2513
  • New package release: v3.20.3 by @github-actions[bot] in #2528

Full Changelog: 3.20.2…3.20.3

26 August 2025

21:11:00 GMT+0000

v3.20.0

VIP-CLI
Permalink

Changed

  • New develop release: 3.19.3-dev.0 by @github-actions[bot] in #2493
  • build(deps): bump actions/checkout from 4 to 5 by @dependabot[bot] in #2499
  • build(deps-dev): bump @types/node from 24.2.0 to 24.2.1 by @dependabot[bot] in #2498
  • chore: update dependencies and refactor code for compatibility by @sjinks in #2495
  • test(backup-storage): show cursor after each test run by @sjinks in #2496
  • fix(import-sql): improve URL validation logic by @sjinks in #2500
  • docs: add instructions for code review, commit message, and changelog generation by @sjinks in #2491
  • build(deps-dev): bump the babel group with 3 updates by @dependabot[bot] in #2503
  • build(deps-dev): bump @types/node from 24.2.1 to 24.3.0 by @dependabot[bot] in #2504
  • chore(deps): remove unused dependencies by @sjinks in #2502
  • build(deps): bump chalk from 5.5.0 to 5.6.0 by @dependabot[bot] in #2505
  • build(deps): bump actions/dependency-review-action from 4.7.1 to 4.7.2 by @dependabot[bot] in #2507
  • feat: add header support for URL imports in import sql command by @luismulinari in #2511
  • build(deps): bump ssh2 from 1.16.0 to 1.17.0 by @dependabot[bot] in #2509
  • build(deps-dev): bump @types/dockerode from 3.3.42 to 3.3.43 by @dependabot[bot] in #2508
  • Add live backup copy support for partial dev-env db sync and db export by @luismulinari in #2476
  • New package release: v3.20.0 by @github-actions[bot] in #2516

Full Changelog: 3.19.2…3.20.0

07 August 2025

21:30:02 GMT+0000

v3.19.2

VIP-CLI
Permalink

The primary focus of this PR is on enhancing environment checks, clarifying command usage, and maintaining compatibility with updated dependencies.

Key updates in this release include:

Environment and Command Improvements:

  • Improved environment checks for importing or syncing local databases to prevent common errors.
  • Prevented unsupported commands from running in incompatible environments, and removed outdated options from environment info commands.
  • Deprecated the extended option in the vip dev-env info command.
  • Updated import and sync commands for reliability.
  • Disallowed running WP-CLI commands from Node Apps for better environment safety.

Dependency Upgrades:

Upgraded typescript from 5.8.3 to 5.9.2, @automattic/vip-search-replace from 1.1.3 to 2.0.0, and @types/node from 24.1.0 to 24.2.0 for improved compatibility and future support.

What’s Changed

  • refactor(dev-env): deprecate extended option in vip dev-env info by @sjinks in #2482
  • build(deps-dev): bump typescript from 5.8.3 to 5.9.2 by @dependabot[bot] in #2484
  • build(deps): bump @automattic/vip-search-replace from 1.1.3 to 2.0.0 by @dependabot[bot] in #2483
  • Do not allow WP-CLI commands to be run from Node Apps by @rebeccahum in #2486
  • build(deps-dev): bump @types/node from 24.1.0 to 24.2.0 by @dependabot[bot] in #2487
  • refactor(dev-env): use isContainerRunning for import and sync commands by @sjinks in #2489

Full Changelog: 3.19.1…3.19.2

11 December 2024

20:42:28 GMT+0000

v3.9.3

VIP-CLI
Permalink

In v3.8.4, we improved the vip dev-env sync sql command to handle search-replace for multisites that simultaneously utilize both subdomains and subfolders in their URL (e.g. example.test/subfolder-site and subdomain.example.test/subfolder-site). While search-replace now produces consistent results, this change introduced a side-effect: a site’s primary domain is replaced with it’s slugified version.

v3.9.3 addresses this issue and ensures the expected mapping should look like:

primary_domain => env_slug.vipdev.lndo.site
convenience_domain => env_slug.vipdev.lndo.site
any_other_domain_or_subdomain => slugified_any_other_domain_or_subdomain.env_slug.vipdev.lndo.site

Paths are handled respectively as follows: primary_domain/my/site/ => env_slug.vipdev.lndo.site/my/site

07 May 2024

18:23:23 GMT+0000

v2.39.6

VIP-CLI
Permalink

Updates the custom deploy functionality, enabling deploys to be triggered with only a custom deploy token. There are breaking changes associated with this, so you will need to update the VIP CLI to the latest version if using custom deployments: npm i -g @automattic/vip

This functionality is currently in closed beta. Please reach out to VIP Support if you would like to join in on the beta test.

01 May 2024

21:17:07 GMT+0000

v2.39.4

VIP-CLI
Permalink

Recent changes to official MySQL image resulted in inability to start database containers due to disabling mysql-native-password auth plugin.

If you’re affected, please update your VIP-CLI install via npm i -g @automattic/vip. On the next Local Dev Env start your Landofile will be upgraded to a version that has incompatibility addressed. Your existing Landofile will be backed up as .lando.backup.ymlprior to the upgrade.

19 May 2022

14:43:19 GMT+0000

v2.12.0

VIP-CLI
Permalink

What’s Changed

  • #1035 and #1032 Improved publishing checks to publish on npm
  • #1037 [dev-env] only record the php version numbers update/clean_php_version
  • #999 Add Feature to Support HTTPS/HTTP/NO_PROXY Settings
  • #1036 Move DO_NOT_TRACK handling to Analytics lib
  • #1033 [dev-env] Bump lando in order to support node 18

Special thanks

frank-cerny for the contribution on #999

New Contributors

Full Changelog: v2.11.2…v2.12.0