upgrade

The upgrade command downloads and installs the latest version of the crewship CLI.

Usage

crewship upgrade [options]

Options

Option	Description
`-f, --force`	Force reinstall even if already on latest version
`-h, --help`	Show help message

How It Works

The upgrade process:

Check for updates - Fetches the latest version information from the Crewship API
Download - Downloads the binary for your platform
Verify - Validates the SHA256 checksum to ensure integrity
Backup - Creates a backup of the current binary
Install - Replaces the current binary with the new version
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 / Linux
Windows

# 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/

Invoke-WebRequest -Uri "https://api.crewship.dev/cli/releases/latest/download?platform=windows-x64" -OutFile "$env:LOCALAPPDATA\Programs\crewship.exe"

Getting Started

CLI Reference

Configuration

Guides

Usage

Options

How It Works

Examples

Check for and Install Updates

Force Reinstall

Automatic Update Notifications

Security

Troubleshooting

Permission Denied

Manual Update

​Usage

​Options

​How It Works

​Examples

​Check for and Install Updates

​Force Reinstall

​Automatic Update Notifications

​Security

​Troubleshooting

​Permission Denied

​Manual Update

Usage

Options

How It Works

Examples

Check for and Install Updates

Force Reinstall

Automatic Update Notifications

Security

Troubleshooting

Permission Denied

Manual Update