Tags

wit tag                      # List all tags
wit tag v1.0.0               # Create lightweight tag
wit tag -a v1.0.0 -m "msg"   # Create annotated tag
wit tag -d v1.0.0            # Delete tag
wit tag -l "v1.*"            # List tags matching pattern
wit tag -v v1.0.0            # Show tag details

# Create lightweight tag at HEAD
wit tag v1.0.0

# Create at specific commit
wit tag v1.0.0 abc1234

# Output:
# ✓ Created tag 'v1.0.0'
#   Points to: abc1234

# Create annotated tag
wit tag -a v1.0.0 -m "Release version 1.0.0"

# Output:
# ✓ Created annotated tag 'v1.0.0'
#   Object: def5678

# List all tags
wit tag
# v0.1.0
# v0.2.0
# v1.0.0
# v1.0.1

# List tags matching pattern
wit tag -l "v1.*"
# v1.0.0
# v1.0.1

# List with release candidates
wit tag -l "*-rc*"
# v2.0.0-rc1
# v2.0.0-rc2

# Show tag information
wit tag -v v1.0.0

# Output for annotated tag:
# tag v1.0.0
# Target: abc1234
# Type: annotated
# Tagger: Jane Doe <jane@example.com>
# Date: 3/15/2024, 2:30:00 PM
#
# Release version 1.0.0
#
# Features:
# - New dashboard UI
# - Improved performance

# Output for lightweight tag:
# tag v0.1.0
# Target: def5678
# Type: lightweight

wit show v1.0.0

# Delete a local tag
wit tag -d v1.0.0
# ✓ Deleted tag 'v1.0.0'

# Delete multiple tags
wit tag -d v0.1.0 v0.2.0

# Push a specific tag
wit push origin v1.0.0

# Push all tags
wit push --tags

# Delete a remote tag
wit push --delete origin v1.0.0

v<major>.<minor>.<patch>[-<prerelease>]

Examples:
v1.0.0        # Initial release
v1.0.1        # Patch release (bug fixes)
v1.1.0        # Minor release (new features, backward compatible)
v2.0.0        # Major release (breaking changes)
v2.0.0-rc1    # Release candidate
v2.0.0-beta.1 # Beta release

# 1. Ensure you're on the release commit
wit switch main
wit pull

# 2. Create an annotated tag with release notes
wit tag -a v1.0.0 -m "Release v1.0.0

Features:
- New user dashboard
- API improvements
- Performance optimizations

Bug fixes:
- Fixed login timeout issue
- Corrected date formatting"

# 3. Push the tag
wit push origin v1.0.0

# Or push all tags
wit push --tags

# Tag a specific commit
wit tag -a v0.9.0 abc1234 -m "Retroactive tag for v0.9.0"

# Find the commit you want to tag
wit log --oneline
# def5678 Add feature X
# abc1234 Prepare for release  <- tag this one
# 111222 Fix bug

# Major release
wit tag -a v2.0.0 -m "Version 2.0.0 - Complete rewrite

Breaking changes:
- New API endpoints
- Removed deprecated functions

Migration guide: https://docs.example.com/migrate-v2"

# Patch release
wit tag -a v1.0.1 -m "Hotfix for authentication bug"

# Pre-release
wit tag -a v2.0.0-rc1 -m "Release candidate 1 for v2.0.0"

# Find which tag contains a commit
wit tag --contains abc1234

# List tags in version order
wit tag -l "v*" | sort -V

# Get the latest tag
wit describe --tags --abbrev=0

# If you need to move a tag to a different commit
wit tag -d v1.0.0
wit tag -a v1.0.0 <new-commit> -m "Release v1.0.0"

# Or force replace
wit tag -f v1.0.0 <new-commit>