Upgrade

Easily upgrade curl-runner to the latest version with automatic installation source detection.

Copy Markdown

Overview

The curl-runner upgrade command automatically detects how curl-runner was installed and uses the appropriate method to upgrade to the latest version.

Auto-Detection

Detects bun, npm, or curl installation

One Command

Simple upgrade regardless of install method

Version Check

Automatic notification when updates available

Basic Usage

Run the upgrade command to update to the latest version.

Upgrade Commands
# Upgrade to latest version (auto-detects installation method)
curl-runner upgrade

# Preview what would happen without executing
curl-runner upgrade --dry-run

# Force reinstall even if already on latest version
curl-runner upgrade --force

Options

Available options for the upgrade command.

-n, --dry-run

Preview the upgrade command without executing it. Useful for seeing what would happen.

-f, --force

Force reinstall even if already on the latest version. Useful for troubleshooting or reinstalling a clean copy.

Installation Detection

curl-runner automatically detects the installation source and uses the appropriate upgrade method.

bunbun install -g @curl-runner/cli@latest
npmnpm install -g @curl-runner/cli@latest
curlcurl -fsSL https://www.curl-runner.com/install.sh | bash
standalonecurl -fsSL https://www.curl-runner.com/install.sh | bash
Detection Logic
# curl-runner automatically detects how it was installed:
#
# bun (global)     → runs: bun install -g @curl-runner/cli@latest
# npm (global)     → runs: npm install -g @curl-runner/cli@latest
# curl installer   → runs: curl -fsSL https://www.curl-runner.com/install.sh | bash
# standalone       → runs: curl -fsSL https://www.curl-runner.com/install.sh | bash

Automatic Version Check

curl-runner automatically checks for updates when you run commands. If a newer version is available, you'll see a notification.

Update Notification
# curl-runner checks for updates on every run
# If a new version is available, you'll see:

╭───────────────────────────────────────────────╮
│                                               │
│  Update available! 1.15.0 → 1.16.0            │
│                                               │
│  Run curl-runner upgrade to update            │
│                                               │
╰───────────────────────────────────────────────╯

Non-blocking Check

Version checks run in the background and don't slow down your commands. Results are cached for 24 hours. Checks are skipped in CI environments.

Output Example

Here's what a successful upgrade looks like.

Upgrade Output
$ curl-runner upgrade

curl-runner upgrade

Installation: bun (global)
Current version: 1.15.0
Latest version: 1.16.0

Upgrading...

bun install v1.1.0 (abc1234)
+ @curl-runner/cli@1.16.0

Upgrade complete!

Run `curl-runner --version` to verify.

Manual Upgrade

If automatic upgrade doesn't work, you can use these manual commands.

Manual Upgrade Commands
# If automatic upgrade fails, use manual commands:

# For bun installations
bun install -g @curl-runner/cli@latest

# For npm installations
npm install -g @curl-runner/cli@latest

# For curl/standalone installations (Unix)
curl -fsSL https://www.curl-runner.com/install.sh | bash

# For curl/standalone installations (Windows PowerShell)
irm https://www.curl-runner.com/install.ps1 | iex

Permission Issues

If you encounter permission errors during upgrade, try these solutions.

Permission Solutions
# If you get permission errors on Unix:
sudo npm install -g @curl-runner/cli@latest

# Or for curl installer, you may need to change install directory:
CURL_RUNNER_INSTALL_DIR=/usr/local/bin curl -fsSL https://www.curl-runner.com/install.sh | bash