vers alias              # List all aliases
vers alias <name>       # Show VM ID for specific alias

vers alias

web-server -> vm-abc123def456
database -> vm-789xyz012345
test-env -> vm-qwerty098765

vers alias web-server

vm-abc123def456

{
  "web-server": "vm-abc123def456",
  "database": "vm-789xyz012345"
}

# When starting a new environment
vers run --vm-alias my-dev-env

# When branching
vers branch --alias feature-test

# When restoring from a commit
vers run-commit c123456 --vm-alias restored-env

vers connect my-dev-env      # Instead of: vers connect vm-abc123
vers checkout my-dev-env     # Instead of: vers checkout vm-abc123
vers execute my-dev-env "ls" # Instead of: vers execute vm-abc123 "ls"
vers status my-dev-env       # Instead of: vers status vm-abc123
vers kill my-dev-env         # Instead of: vers kill vm-abc123
vers copy my-dev-env:/path . # Instead of: vers copy vm-abc123:/path .

# Create environment with alias
vers run --vm-alias dev

# Work with it using the alias
vers connect dev
# ... do work ...
exit

# Branch with a new alias
vers branch --alias feature-x

# Switch between them easily
vers checkout dev
vers checkout feature-x

# Check your aliases
vers alias
# Output:
# dev -> vm-abc123
# feature-x -> vm-def456

# Get VM ID for use in scripts
VM_ID=$(vers alias my-env)
echo "Working with VM: $VM_ID"

vers alias nonexistent
# Error: alias 'nonexistent' not found

vers alias
# No aliases defined.

vers run --vm-alias dev-main
# ...later, from anywhere...
vers connect dev-main

vers alias set my-app vm-abc123

VM_ID=$(vers alias lookup my-app)