vandor.
CLI Reference

vandor upgrade

Upgrade Vandor CLI to the latest version

Synopsis

Upgrade Vandor CLI to the latest version from GitHub releases.

vandor upgrade [flags]

Description

The upgrade command checks for new versions of Vandor CLI and upgrades your installation automatically.

Usage

Basic upgrade:

vandor upgrade

Upgrade Process

1. Check Current Version
   -> vandor v0.4.0

2. Check GitHub for Latest Release
   -> Latest: v0.4.1

3. Download Binary
   -> Downloading vandor-v0.4.1-linux-amd64
   -> [====================] 100%

4. Verify Checksum
   -> Checksum verified

5. Backup Current Version
   -> Saved to /usr/local/bin/vandor.bak

6. Replace Binary
   -> Installed to /usr/local/bin/vandor

7. Verify Installation
   -> vandor v0.4.1

8. Update Shell Completions (if installed)
   -> Regenerating completions...
   -> Completions updated

Upgrade completed successfully!

Automatic Completion Updates

When you upgrade Vandor CLI, shell completions are automatically regenerated if they were previously installed in standard locations:

  • Zsh: ~/.oh-my-zsh/completions/_vandor
  • Bash: ~/.local/share/bash-completion/completions/vandor
  • Fish: ~/.config/fish/completions/vandor.fish

After upgrading, restart your shell to use the updated completions with new commands and flags.

Flags

--version string     # Upgrade to specific version
--force             # Force upgrade even if same version
--dry-run           # Show what would be upgraded
--no-backup         # Don't create backup

Examples

Upgrade to latest

vandor upgrade

Upgrade to specific version

vandor upgrade --version=v0.4.1

Dry run

Check for updates without installing:

vandor upgrade --dry-run

Output:

Current version: v0.4.0
Latest version:  v0.4.1
Upgrade available: yes

Changes in v0.4.1:
  - Improved vpkg sync performance
  - Fixed context scaffold edge cases
  - Bug fixes and stability improvements

Run 'vandor upgrade' to install

Force upgrade

Reinstall current version:

vandor upgrade --force

Rollback

If upgrade causes issues, rollback to previous version:

# Restore from backup
sudo cp /usr/local/bin/vandor.bak /usr/local/bin/vandor

# Verify
vandor --version

Version Check

Check for updates without upgrading:

vandor version --check-update

Update Notifications

Vandor checks for updates periodically and shows notification:

+---------------------------------------------+
|  Update Available!                          |
|                                             |
|  v0.4.1 is now available (you have v0.4.0) |
|                                             |
|  Run 'vandor upgrade' to update            |
|                                             |
|  Release notes:                            |
|  github.com/alfariiizi/vandor/releases     |
+---------------------------------------------+

Disable update checks:

# ~/.config/vandor/config.yaml
cli:
  check_updates: false

Upgrade from Source

If no GitHub releases available:

vandor upgrade --source

This builds from the latest source code:

1. Clone repository
2. Build from source
3. Install binary

Troubleshooting

Permission denied

Error: permission denied

Solution: Use sudo:

sudo vandor upgrade

Network error

Error: failed to download

Solution: Check internet connection and try again.

Checksum mismatch

Error: checksum verification failed

Solution: Download may be corrupted. Try again or upgrade from source.

Next Steps