megachangelog
Improvement4.0.1

Vercel Sandbox CLI is now more agent-friendly

Sandbox CLI 4.0.1 improves output and error messages with actionable next steps, better formatting for create and fork commands, quieter errors with debugging support, an interactive sh shell, automatic update checks, and client-side defaults to ensure outdated installs don't break functionality.

The Sandbox CLI version ships four output and error improvements:4.0.1

Each of these messages now carries the action to take next instead of leaving you to work it out.

and output now ends with a connect hint, so a fresh sandbox never leaves you wondering what to type next.createfork

When a command references a sandbox that does not exist, the error is quiet and actionable instead of a raw API dump. Setting restores the request detail for debugging.DEBUG=sandbox:errors

opens a plain interactive shell, so it takes no command of its own. The CLI can now return precise answers that rewrite the attempt into the command that does what you meant, whatever the command is.sh

, , and check for a newer published CLI and print an update notice when the install is behind. The check is cached to a file and refreshed at most once per hour; when a lookup does run it happens concurrently with the creation request, so it adds no latency. Creation defaults, such as the base image, are chosen client side, so an outdated global install silently keeps old defaults. Prerelease versions skip the check, and disables it.createshrunSANDBOX_SKIP_VERSION_CHECK=1

Learn more in the .Sandbox CLI documentation

Read more

  • New sandboxes point users towards how to connect into them.

  • A sandbox not found error shows where to look for existing sandboxes.

  • Common mistakes, like typing a command after , redirect to the command that was intended.sh

  • Outdated installs show an update notice when they create a new sandbox.

New sandboxes tell you how to connect

Not found errors point you to your sandboxes

A misused command explains the right one

Outdated installs warn you at creation time

sandboxcliuxerror-handlingtooling

Source: original entry ↗

More from Vercel

Follow Vercel to get its new changes in your feed and email digest.

Feature

Agents can now buy domains with the Vercel CLI

Vercel CLI now enables agents to discover, check availability, and initiate domain purchases through structured commands, with purchase confirmation remaining under user control via interactive terminal or dashboard approval.

clidomainsagentsapi
Announcement

New Pro teams default to 30-day deployment retention

Pro teams now default to a 30-day deployment retention period to balance keeping recent history available while reducing storage costs. You can configure a longer retention period in team settings if needed.

deploymentsstoragepro-teamspricing
Announcement

Deployment Storage billing begins for existing Pro teams

Pro teams will now be charged for Deployment Storage and Functions Storage at $0.10 per GB-month. The default deployment retention window changes to 30 days, with deployments older than 30 days deleted automatically unless you adjust your retention settings beforehand.

billingstoragepricingdeployments
See all Vercel changes →