devo upgrade¶

Upgrade the CLI tool to the latest version from GitHub Releases.

Synopsis¶

devo upgrade [OPTIONS]

Description¶

Automatically downloads and installs the latest version of Devo CLI from GitHub Releases. Supports binary upgrades for Linux, macOS, and Windows.

Options¶

Option	Short	Description
`--force`	`-f`	Force upgrade without confirmation
`--check`	`-c`	Check for updates without upgrading
`--help`		Show help message and exit

Usage¶

Check for Updates¶

# Check if new version is available
devo upgrade --check

Output:

Current version: 1.2.0
Latest version: 1.3.0
New version available!

or

Current version: 1.3.0
Latest version: 1.3.0
You are already on the latest version.

Upgrade¶

# Upgrade with confirmation
devo upgrade

# Upgrade without confirmation
devo upgrade --force

Interactive flow:

Current version: 1.2.0
Latest version: 1.3.0

New version available!

Changelog:
- feat: Add new SSM database commands
- fix: Improve error handling in commit command
- docs: Update documentation

Upgrade to version 1.3.0? [Y/n]: y

Downloading devo-linux-amd64...
✓ Download complete
✓ Verifying binary...
✓ Installing...
✓ Upgrade successful!

Devo CLI upgraded to version 1.3.0

How It Works¶

Version Check: Compares current version with latest GitHub release
Download: Downloads platform-specific binary from GitHub Releases
Verification: Verifies binary integrity
Backup: Creates backup of current binary
Installation: Replaces current binary with new version
Cleanup: Removes temporary files

Platform Support¶

Platform	Binary Format	Notes
Linux	Single file	Direct replacement
macOS	Tarball (.tar.gz)	Extracts to directory
Windows	ZIP (.zip)	Extracts to directory

Installation Locations¶

The upgrade command detects your installation location:

/usr/local/bin/devo - System-wide installation
~/.local/bin/devo - User installation
Custom locations - Detected from current binary path

Examples¶

Basic Upgrade¶

# Check for updates
devo upgrade --check

# Upgrade if available
devo upgrade

Force Upgrade¶

# Upgrade without confirmation
devo upgrade --force

Automated Upgrade (CI/CD)¶

# Non-interactive upgrade
devo upgrade --force

# Check exit code
if [ $? -eq 0 ]; then
  echo "Upgrade successful"
else
  echo "Upgrade failed"
fi

Automatic Version Checks¶

Devo CLI automatically checks for new versions periodically (configurable):

# Disable automatic version checks
devo config set version_check.enabled false

# Enable automatic version checks
devo config set version_check.enabled true

When a new version is available, you'll see a notification:

A new version of Devo CLI is available: 1.3.0 (current: 1.2.0)
Run 'devo upgrade' to update.

Rollback¶

If the upgrade fails or you want to rollback:

# The old binary is backed up as devo.backup
# Restore it manually:

# Linux/macOS
sudo mv /usr/local/bin/devo.backup /usr/local/bin/devo

# Or for user installation
mv ~/.local/bin/devo.backup ~/.local/bin/devo

Troubleshooting¶

Permission denied¶

Error: Permission denied

Solution: Run with sudo for system-wide installation:

sudo devo upgrade

Or upgrade to user directory:

# Install to ~/.local/bin instead
curl -fsSL https://raw.githubusercontent.com/edu526/devo-cli/main/install.sh | bash

Download failed¶

Error: Failed to download binary

Possible causes:

No internet connection
GitHub is down
Firewall blocking access

Solution:

# Check internet connection
curl -I https://github.com

# Try again
devo upgrade --force

Binary verification failed¶

Error: Binary verification failed