gws update
Self-update the gws CLI by downloading the pre-built binary for your platform from the GetWebstack release bucket and replacing the running executable in-place.
Every successful update also re-runs the skill-symlink installer (the same code path as gws skills install), so the /gws-setup, /gws-up, /gws-status, /gws-down, and /gws-debug skills stay current with whatever shipped in the new release.
Usage
gws update [options]
| Flag | Description | Default |
|---|---|---|
--check | Check for updates without installing. Prints whether an upgrade is available, then exits. Wins over --force — --check --force only prints, never installs. | false |
--force | Re-install even if you're already on the latest version. | false |
--target <version> | Install a specific version (e.g. 0.1.95). | latest from latest/version.txt |
Auth: not required.
Why no
-vshorthand for--target?-vis reserved for--verboseby the Commander wrapper.
Supported platforms
linux-x64, linux-arm64, darwin-x64, darwin-arm64, windows-x64. The binary is fetched from https://storage.googleapis.com/getwebstack-cli/releases/<version>/<platform>/.
On Windows, the symlink-based installer requires either administrator privileges or Developer Mode; without one of those gws update's skill-refresh step will fail with EPERM. A copy-mode fallback is on the roadmap. See gws skills.
Examples
# Check whether an upgrade is available, exit
gws update --check
# Upgrade to latest
gws update
# Pin to a specific version (e.g. for reproducible CI)
gws update --target 0.1.95
# Re-install the current version (useful if skills got removed)
gws update --force
See also
gws skills install— same skill-symlink logic, callable on its own- Installation — first-time install