vandor version

Synopsis

Display Vandor CLI version and build information.

vandor version [flags]

Usage

Basic version check:

vandor version

Output:

Vandor CLI v0.4.0
Go version: go1.24.1
Platform: linux/amd64
Build date: 2026-01-15T10:30:00Z
Commit: abc123def456

Short version:

vandor --version
# or
vandor -v

Output:

vandor v0.4.0

Flags

--short             # Show version number only
--check-update      # Check for available updates
--json              # Output in JSON format

Examples

Version number only

vandor version --short

Output:

v0.4.0

Check for updates

vandor version --check-update

Output:

Current version: v0.4.0
Latest version:  v0.4.1

Update available! Run 'vandor upgrade' to update.

Release notes: https://github.com/alfariiizi/vandor/releases/v0.4.1

JSON output

vandor version --json

Output:

{
  "version": "v0.4.0",
  "go_version": "go1.24.1",
  "platform": "linux/amd64",
  "build_date": "2026-01-15T10:30:00Z",
  "commit": "abc123def456",
  "latest_version": "v0.4.1",
  "update_available": true
}

Version Information

The version output includes:

Version - Semantic version (v0.4.0) Go version - Go compiler version used Platform - OS and architecture Build date - When this binary was built Commit - Git commit hash

Semantic Versioning

Vandor follows semantic versioning (semver):

v0.4.0
| | |
| | +- Patch: Bug fixes
| +--- Minor: New features (backward compatible)
+----- Major: Breaking changes

Examples:

v0.4.0 -> v0.4.1: Bug fixes only
v0.4.0 -> v0.5.0: New features added
v0.4.0 -> v1.0.0: Breaking changes

Version Compatibility

CLI vs Project

Check if CLI version is compatible with project:

cd my-project
vandor version

Output shows compatibility:

Vandor CLI v0.4.1
Project version: v0.4.0

Warning: CLI version (v0.4.1) is newer than project (v0.4.0)
   Project may not support all CLI features.

VPKG Compatibility

Some VPKG packages require specific CLI versions:

vandor vpkg add @official/http-humachi

If incompatible:

Error: Package '@official/http-humachi' requires Vandor CLI v0.4.0+
       You have v0.2.0

       Run 'vandor upgrade' to update

Environment Variables

VANDOR_VERSION=v0.4.0  # Override version display

Version in Scripts

Use in shell scripts:

#!/bin/bash

# Check Vandor is installed
if ! command -v vandor &> /dev/null; then
    echo "Vandor CLI not found"
    exit 1
fi

# Check minimum version
VERSION=$(vandor version --short)
REQUIRED="v0.4.0"

if [[ "$VERSION" < "$REQUIRED" ]]; then
    echo "Vandor CLI $REQUIRED or higher required"
    echo "You have $VERSION"
    exit 1
fi

# Proceed with build
vandor sync all

Next Steps

vandor upgrade - Upgrade Vandor CLI
Installation - Installation guide

vandor version

On this page