Git Tag Generate

Herramienta CLI moderna para generar tags Git siguiendo Semantic Versioning (SemVer) con soporte para prefijos, prerelease y gestión avanzada de tags.

Características

• ✨ CLI Híbrido: comandos explícitos y atajos ergonómicos
• 🎯 SemVer Completo: patch, minor, major, prepatch, preminor, premajor, prerelease
• 🏷️ Prefijos Flexibles: organiza tags por proyecto/módulo con prefijos normalizados
• 🚀 Prerelease: soporte para beta, alpha, rc y identificadores personalizados
• 🗑️ Borrado Múltiple: elimina varios tags a la vez con multi-select
• 🔍 Listado: agrupa tags por prefijo, muestra historial ordenado
• ✅ Validaciones: verifica repo Git, remote origin, rama actual, duplicados

Requisitos

• Node.js ≥ 20.0.0

Instalación

Global (recomendado)

npm install -g git-tag-generate

o

pnpm install -g git-tag-generate

Uso

Comportamiento Inteligente

Al ejecutar gtg sin argumentos, la herramienta detecta automáticamente el estado del repositorio:

• Sin tags existentes: ejecuta gtg new para crear el primer tag (0.0.1)
• Con tags existentes: ejecuta gtg next para incrementar desde el último tag

Comandos

| Comando | Descripción | | - | - | | gtg | Flujo inteligente: new si no hay tags, next si ya existen | | gtg new | Crear primer tag con versión inicial 0.0.1 | | gtg next | Generar siguiente tag con incremento SemVer | | gtg list | Listar todos los tags agrupados por prefijo | | gtg delete | Eliminar tags con selección múltiple |

Atajos

Los siguientes atajos ejecutan gtg next --level <nivel>:

| Atajo | Equivalente | Descripción | | - | - | - | | gtg patch | gtg next -l patch | Incrementa versión patch (0.0.X) | | gtg minor | gtg next -l minor | Incrementa versión minor (0.X.0) | | gtg major | gtg next -l major | Incrementa versión major (X.0.0) | | gtg prepatch | gtg next -l prepatch | Prepatch con prerelease (0.0.X-beta.0) | | gtg preminor | gtg next -l preminor | Preminor con prerelease (0.X.0-beta.0) | | gtg premajor | gtg next -l premajor | Premajor con prerelease (X.0.0-beta.0) | | gtg prerelease | gtg next -l prerelease | Incrementa número de prerelease |

Flags

| Flag | Alias | Descripción | | - | - | - | | --level <nivel> | -l | Especifica nivel de incremento SemVer | | --beta | - | Usa identificador beta para prerelease | | --alpha | - | Usa identificador alpha para prerelease | | --id <id> | - | Identificador personalizado para prerelease | | --noPush | - | Crea el tag localmente sin subirlo al remote | | --dry-run | - | Simula la operación sin crear el tag | | --prefixes | - | Lista solo los prefijos disponibles (con list) | | --help | -h | Muestra ayuda |

Ejemplos

Crear primer tag

# Interactivo: pregunta por prefijo y crea tag 0.0.1
gtg new

# Ejemplo de flujo:
# ¿Deseas usar un prefijo para el tag? (y/N): y
# Ingresa el prefijo: my-app
# Prefijo normalizado: my-app
# Versión inicial: 0.0.1
# ¿Crear tag 'my-app-0.0.1'? (Y/n): y
# ✓ Tag 'my-app-0.0.1' creado exitosamente y subido al remote

Incrementar versiones

# Incremento básico con atajos
gtg patch    # 0.0.1 → 0.0.2
gtg minor    # 0.0.2 → 0.1.0
gtg major    # 0.1.0 → 1.0.0

# Con flags explícitos
gtg next --level patch
gtg next -l minor

Prerelease

# Crear prerelease beta
gtg prepatch --beta           # 1.0.0 → 1.0.1-beta.0
gtg preminor --beta           # 1.0.1 → 1.1.0-beta.0
gtg premajor --beta           # 1.0.0 → 2.0.0-beta.0

# Incrementar prerelease existente
gtg prerelease --beta         # 1.0.1-beta.0 → 1.0.1-beta.1

# Con identificadores personalizados
gtg prepatch --alpha          # 1.0.0 → 1.0.1-alpha.0
gtg prepatch --id rc          # 1.0.0 → 1.0.1-rc.0
gtg next -l prepatch --id canary

Listar tags

# Listar todos los tags agrupados por prefijo
gtg list

# Ejemplo de salida:
# Tags encontrados: 8
#
# my-app:
#   → my-app-1.0.0 (2026-01-25T10:30:00)
#     my-app-0.1.0 (2026-01-24T15:20:00)
#     my-app-0.0.1 (2026-01-23T09:00:00)
#
# (sin prefijo):
#   → 2.0.0 (2026-01-22T12:00:00)

# Listar solo prefijos
gtg list --prefixes

Eliminar tags

# Multi-select interactivo
gtg delete

# Ejemplo de flujo:
# Selecciona los tags a eliminar:
#   ◉ my-app-0.0.1 (2026-01-23)
#   ◯ my-app-0.1.0 (2026-01-24)
#   ◉ my-app-1.0.0-beta.0 (2026-01-25)
#
# Tags a eliminar (2):
#   - my-app-0.0.1
#   - my-app-1.0.0-beta.0
#
# ¿Estás seguro de eliminar 2 tag(s)? (y/N): y
# ✓ my-app-0.0.1: eliminado local y remotamente
# ✓ my-app-1.0.0-beta.0: eliminado local y remotamente

Opciones avanzadas

# Crear tag sin subirlo al remote
gtg patch --noPush

# Simular creación (dry run)
gtg major --dry-run

# Combinar flags
gtg prepatch --beta --noPush --dry-run

Prefijos

Los prefijos permiten organizar tags por proyecto, módulo o entorno:

• Con prefijo: my-app-1.0.0, backend-2.5.0, frontend-0.3.1
• Sin prefijo: 1.0.0, 2.0.0

Normalización automática

Los prefijos se normalizan siguiendo estas reglas:

• Convertidos a minúsculas
• Espacios y guiones bajos → guiones (-)
• Caracteres especiales eliminados
• Solo alfanuméricos y guiones permitidos
• No pueden empezar/terminar con guión

# Entrada → Salida normalizada
"My App"     → "my-app"
"backend_v2" → "backend-v2"
"Front-End!" → "front-end"

Validaciones

La CLI realiza las siguientes validaciones automáticas:

• ✓ Repositorio Git válido: verifica que estés en un repo Git
• ✓ Remote origin: confirma existencia del remote antes de push
• ✓ Rama actual: advierte si no estás en main/master y pide confirmación
• ✓ Tags duplicados: previene creación de tags existentes
• ✓ Formato SemVer: valida que las versiones cumplan el estándar

Licencia

GPL-3.0 license

Autor

GitHub | X | Website