Skip to main content
The upgrade command downloads and installs the latest version of the crewship CLI.

​
Usage

crewship upgrade [options]

​
Options

OptionDescription
-f, --forceForce reinstall even if already on latest version
-h, --helpShow help message

​
How It Works

The upgrade process:
  1. Check for updates - Fetches the latest version information from the Crewship API
  2. Download - Downloads the binary for your platform
  3. Verify - Validates the SHA256 checksum to ensure integrity
  4. Backup - Creates a backup of the current binary
  5. Install - Replaces the current binary with the new version
  6. Cleanup - Removes the backup after successful installation
If anything goes wrong during installation, the original binary is automatically restored.

​
Examples

​
Check for and Install Updates

crewship upgrade
Output when an update is available: 
Checking for updates...
New version available: 0.2.0 (current: 0.1.0)
Downloading crewship 0.2.0 for darwin-arm64...
Verifying checksum...
Checksum verified.
Installing update...

Successfully upgraded to crewship 0.2.0!
Output when already up to date: 
Checking for updates...
You are already running the latest version (0.2.0).

​
Force Reinstall

Reinstall the latest version even if already up to date (useful for repairing a corrupted installation): 
crewship upgrade --force

​
Automatic Update Notifications

Crewship automatically checks for updates once per day when you run any command. If a new version is available, you’ll see a notification: 
┌───────────────────────────────────────────────────────────┐
│  A new version of crewship is available: 0.2.0           │
│  You are currently running: 0.1.0                        │
│                                                           │
│  Run crewship upgrade to update                          │
└───────────────────────────────────────────────────────────┘
This check is non-blocking and won’t slow down your commands. The notification only appears once per new version.

​
Security

  • Checksum verification - All downloads are verified against SHA256 checksums
  • HTTPS - All downloads use HTTPS encryption
  • Atomic updates - The update either completes fully or rolls back

​
Troubleshooting

​
Permission Denied

If you get a permission error, the CLI may have been installed with elevated privileges: 
sudo crewship upgrade
Or reinstall to a user-writable location: 
curl -fsSL https://www.crewship.dev/install.sh | bash

​
Manual Update

If automatic upgrade fails, download manually: 
# macOS (Apple Silicon)
curl -fsSL "https://api.crewship.dev/cli/releases/latest/download?platform=darwin-arm64" -o crewship
chmod +x crewship
mv crewship ~/.local/bin/

# macOS (Intel)
curl -fsSL "https://api.crewship.dev/cli/releases/latest/download?platform=darwin-x64" -o crewship
chmod +x crewship
mv crewship ~/.local/bin/

# Linux
curl -fsSL "https://api.crewship.dev/cli/releases/latest/download?platform=linux-x64" -o crewship
chmod +x crewship
mv crewship ~/.local/bin/