Reference · Error codes

HSX_E_UPDATE_INSTALL_FAILED

Self-update install failed.

What this error means

The package manager exited non-zero while installing the new CLI version.

When this error stops a command, hs-x exits with code 1. With --json, the failure is reported as a structured error whose code field is HSX_E_UPDATE_INSTALL_FAILED — stable to match on in scripts and agents.

Likely causes

  • Global install directory requires elevated permissions (EACCES)
  • Network failure mid-install
  • The package manager that owns the install was misdetected

How to fix it

  • Re-run the printed install command manually (with sudo if your global prefix needs it)
  • Or install directly: npm install -g @hs-x/cli@latest

Still stuck? Re-run the command with --debug for the wire-level detail, or hs-x doctor to check accounts, link state, and connectivity in one pass.

Keep going