Skip to main content

bl upgrade

Upgrade the Blaxel CLI to the latest version

Synopsis

Upgrade the Blaxel CLI to the latest version. This command automatically detects your installation method and updates the CLI in the correct location to avoid version conflicts. Supported installation methods:
  • Homebrew (brew)
  • Manual installation (install.sh, or install.ps1 on Windows)
  • Direct binary download
After upgrading, the newly installed CLI refreshes the Blaxel agent skills and MCP servers for detected coding agents without setup screens or login. Existing custom MCP entries, plugin-managed servers, and externally managed skills are kept. Set BL_INSTALL_SKILLS=false or BL_INSTALL_MCP=false to skip either part. Automatic refresh is skipped in CI unless the corresponding setting is true. If the requested release does not support headless refresh, setup is left alone. Examples:

Upgrade to the latest version

bl upgrade

Upgrade to a specific version

bl upgrade —version v1.2.3

Force reinstall even if already on latest version

bl upgrade —force

Options

Options inherited from parent commands

SEE ALSO

  • bl - Blaxel CLI - manage and deploy AI agents, sandboxes, and resources
Last modified on October 21, 2026