skills/bun-guides-util-upgrade/SKILL.md
Upgrade Bun to the latest version
npx skillsauth add jarle/bun-skills Bun Upgrade Bun to the latest versionInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Bun can upgrade itself using the built-in bun upgrade command. This is the fastest way to get the latest features and bug fixes.
bun upgrade
This downloads and installs the latest stable version of Bun, replacing the currently installed version.
<Note>To see the current version of Bun, run bun --version.</Note>
After upgrading, verify the new version:
bun --version
# Output: 1.x.y
# See the exact commit of the Bun binary
bun --revision
# Output: 1.x.y+abc123def
Canary builds are automatically released on every commit to the main branch. These are untested but useful for trying new features or verifying bug fixes before they're released.
bun upgrade --canary
<Warning>Canary builds are not recommended for production use. They may contain bugs or breaking changes.</Warning>
If you're on a canary build and want to return to the latest stable release:
bun upgrade --stable
To install a specific version of Bun, use the install script with a version tag:
<Tabs> <Tab title="macOS & Linux"> ```bash terminal icon="terminal" theme={"theme":{"light":"github-light","dark":"dracula"}} curl -fsSL https://bun.sh/install | bash -s "bun-v1.3.3" ``` </Tab> <Tab title="Windows"> ```powershell PowerShell icon="windows" theme={"theme":{"light":"github-light","dark":"dracula"}} iex "& {$(irm https://bun.sh/install.ps1)} -Version 1.3.3" ``` </Tab> </Tabs>If you installed Bun via a package manager, use that package manager to upgrade instead of bun upgrade to avoid conflicts.
Scoop users <br />
To avoid conflicts with Scoop, use scoop update bun instead.
</Tip>
development
Using TypeScript with Bun, including type definitions and compiler options
development
Learn how to write tests using Bun's Jest-compatible API with support for async tests, timeouts, and various test modifiers
testing
Learn how to use snapshot testing in Bun to save and compare output between test runs
testing
Learn about Bun test's runtime integration, environment variables, timeouts, and error handling