Title: Changelog: VIP-CLI · WordPress VIP Documentation

---

 1. [Changelog](https://docs.wpvip.com/changelog/)
 2. VIP-CLI

#  Changelog: VIP-CLI

VIP-CLI is regularly updated and the current release version can be installed with
the [VIP-CLI package manager](https://www.npmjs.com/package/@automattic/vip/v/latest).
Update the version of VIP-CLI that is installed on a user's local machine with the
command: `npm install -g @automattic/vip`

 [ RSS  ](https://docs.wpvip.com/changelog/vip-cli/feed/)

 Search

Showing page 1 of 2

 06 July 2026

18:05:04 GMT+0000

### v4.0.11

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/4.0.11)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-v4-0-11/)

### Added

 * Added new `vip defensive-mode` commands to enable, disable, and configure defensive
   mode for an environment.
 * Added step-up verification support for protected actions, including automatic
   retry after verification succeeds.

### Changed

 * Non-interactive runs now fail fast when step-up verification is required, unless
   you explicitly opt in to wait with `--rechallenge-wait` or `VIP_RECHALLENGE_WAIT
   =1`.
 * Production defensive-mode mutations in non-interactive workflows now require 
   explicit confirmation bypass via `--skip-confirmation`.
 * Dev-env: Limit `vip-dev-env.yml.ejs` to plain YAML with `<%= configDir %>` substitution.

### Fixed

 * Login and logout now clear cached elevated permissions to prevent reuse across
   account switches on the same machine.

 01 July 2026

11:26:27 GMT+0000

### v4.0.10

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/4.0.10)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-v4-0-10/)

### Fixed

 * Secure storage may be unavailable even if the keychain provider successfully 
   initializes.

 24 June 2026

21:48:25 GMT+0000

### v4.0.9

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/4.0.9)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-v4-0-9/)

### Fixed

 * `vip wp`: Fixed a crash (`ERR_USE_AFTER_CLOSE`) on Node.js 24 when a websocket
   reconnect occurred during a long-running non-interactive command.

 22 June 2026

20:25:37 GMT+0000

### v4.0.6

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/4.0.6)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-v4-0-6/)

### Fixed

 * Fixed file uploads failing with “Response body object should not be disturbed
   or locked” when an upload request was retried, and ensured retries re-stream 
   the file instead of reusing a consumed stream.

 19 June 2026

09:14:59 GMT+0000

### v4.0.5

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/4.0.5)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-v4-0-5/)

### Fixed

 * Fixed a CI type-check failure (`TS2307`) by adding local typings for the optional`
   @postman/node-keytar` module used by secure keychain code paths.
 * Prefer HTTPS for dev environment login URL.
 * Fixed a regression where `vip dev-env update` could skip wizard prompts in interactive
   sessions.
 * Restored expected interactive behavior while preserving non-interactive behavior
   for non-TTY execution.
 * Dev-env: Fixed false positive SQL import validation errors for exported dumps
   containing Unicode line-separator bytes inside string data.
 * Secure keychain will be used if available.
 * No customer-facing changes; test coverage only.
 * Dev-env: Fixed SQL imports of MyDumper-format backups failing with `ERROR 1050:
   Table already exists` when the local database contains existing tables

### Changed

 * Show both HTTP and HTTPS versions of the login URL.
 * Documented CLI parser migration guardrails for short-option equals syntax and
   parser-backed option defaults.
 * Custom Deployments: Add a pre-deploy check for `vip app deploy` that warns when
   the deployment archive contains nested archive files over 50 MB

### Related

 * Refs PLTFRM-22 / PLTFRM-1032 (prior MyDumper import escalations)
 * Companion PRs: #2872 (search-replace size fix), #2873 (ENGINE validation), #2874(
   DB tuning)
 * 🤖 Generated with Claude Code

### Added

 * Added `vip app deploy-token generate` to generate deploy tokens for a selected
   application environment.
 * Added a release smoke test script for high-risk VIP-CLI parser and dispatch checks.

 08 May 2026

18:20:47 GMT+0000

### v4.0.1

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/4.0.1)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-v4-0-1/)

### Fixed

 * `vip dev-env logs` implementation. It is now faster and more stable.

 * Fixed regression when passing custom commands to `vip dev-env exec`

 07 May 2026

19:37:37 GMT+0000

### v4.0.0

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/4.0.0)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-v4-0-0/)

### Changed

 * We’ve changed underlying CLI library to Commander

 04 May 2026

10:26:01 GMT+0000

### v3.25.2

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/3.25.2)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-v3-25-2/)

### Changed

 * Edited the command description for `import media` to clarify that it can only
   be run against a production environment.

### Added

 * `vip db phpmyadmin`: Added `--print` option to output the phpMyAdmin URL to stdout
   instead of opening it in a browser.
 * `vip db phpmyadmin`: Added `--print` option to output the phpMyAdmin URL to stdout
   instead of opening it in a browser.
 * `vip db phpmyadmin`: Added `--silent` option to suppress all informational messages(
   useful for scripting).

 12 March 2026

11:34:18 GMT+0000

### v3.25.1

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/3.25.1)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-v3-25-1/)

### Fixed

 * Directory permissions issues for `initOnly` containers
 * “Operation not permitted” and “Command not found” in Lando entrypoint scripts
 * Compatibility with `mydumper` 0.21.3-1

 27 February 2026

09:48:27 GMT+0000

### v3.25.0

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/3.25.0)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-v3-25-0/)

### Fixed

 * Do not display extra output when `vip dev-env exec` is run with `--quiet`

 30 January 2026

19:40:18 GMT+0000

### v3.24.0

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/3.24.0)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-2026-01-30-1940/)

### Added

 * Each Dev Env command execution now logs into separate log file and the file location
   is printed at the end of the execution. This is a quality-of-life improvement
   aimed at significantly reducing the friction around debugging Dev Env issues.

 07 January 2026

19:19:43 GMT+0000

### v3.23.2

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/3.23.2)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-2026-01-07-1919/)

### Removed

 * Dev Env: removed PHP 8.1.

### Added

 * Environment Variables: Add reloading configuration for setting and deleting

 06 January 2026

16:25:19 GMT+0000

### v3.23.1

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/3.23.1)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-2026-01-06-1625/)

### Fixed

 * `vip dev-env sync sql`: query site details only when they are needed. This fixes
   the issue with permissions when `@app.env` is not specified.

 18 December 2025

17:55:41 GMT+0000

### v3.23.0

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/3.23.0)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-2025-12-18-1755/)

### Added

 * Dev Environment: phpMyAdmin and Mailpit are now exposed over TLS/SSL.
 * Added dangerous `--skip-backup` flag to `vip import sql`

 17 December 2025

19:29:37 GMT+0000

### v3.22.6

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/3.22.6)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-2025-12-17-1929/)

### Changed

 * Updated code for compatibility with Apollo Client v4 and GraphQL v16
 * Maintenance: update ESLint configuration and fix issues.

### Fixed

 * Fixed HTTP header handling to prevent duplicate headers
 * Fixed incorrect mutation property access in PHPMyAdmin operations
 * Fixed URI encoding in GraphQL operation names
 * Fixed error handling in JavaScript files to use Apollo Client v4 error patterns
 * Dev Environment: allow `docker-compose` newer than 2.x

 10 December 2025

00:00:23 GMT+0000

### v3.22.5

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/3.22.5)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-2025-12-10-0000/)

### Fixed

 * “Proxying to unknown service” warning when Mailpit or phpMyAdmin is not enabled.
 * Dev Env: Correctly handle containers without name mappings.

 01 December 2025

16:07:51 GMT+0000

### v3.22.3

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/3.22.3)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-2025-12-01-1607/)

### Fixed

 * Fixed download URL breaking oneline progress output in export-sql command

 28 November 2025

20:47:35 GMT+0000

### v3.22.2

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/3.22.2)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-2025-11-28-2047/)

### Added

 * Added `--skip-download` flag to export sql command for URL-only retrieval

 26 November 2025

18:48:47 GMT+0000

### v3.22.1

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/3.22.1)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-2025-11-26-1848/)

### Changed

 * Updated the usage example description for `vip import media` to adhere to style
   guide

### Fixed

 * Automatically pull the Proxy image to ensure that we have the most up-to-date
   and secure traefik`.

 25 November 2025

18:00:06 GMT+0000

### v3.22.0

 [ VIP-CLI ](https://docs.wpvip.com/changelog/vip-cli/)

 [ GitHub  ](https://github.com/Automattic/vip-cli/releases/tag/3.22.0)

 [ Permalink  ](https://docs.wpvip.com/changelog/vip-cli/vip-cli-2025-11-25-1800/)

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

---

 *  Page 1
 *  [Page 2](https://docs.wpvip.com/changelog/vip-cli/page/2/?output_format=md)
 *  [Next](https://docs.wpvip.com/changelog/vip-cli/page/2/?output_format=md)