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

$3

``bash npm install -g git-tag-generate`

o

`bash pnpm install -g git-tag-generate`

`Uso`

`$3`

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

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

`$3`

`$3`

Los siguientes atajos ejecutan gtg next --level :

`$3`

| Flag | Alias | Descripción | | - | - | - | |--level | -l| Especifica nivel de incremento SemVer | |--beta | - | Usa identificador betapara prerelease | |--alpha | - | Usa identificador alphapara prerelease | |--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`

`$3`

`bash

`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

$3

`bash

`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

$3

`bash

`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

$3

`bash

`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

$3

`bash

`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

$3

`bash

`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

`$3`

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

`bash

`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 enmain/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

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

Requisitos

- Node.js ≥ 20.0.0

Instalación

$3

``bash npm install -g git-tag-generate`

o

`bash pnpm install -g git-tag-generate`

`Uso`

`$3`

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

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

`$3`

Los siguientes atajos ejecutan gtg next --level :

`$3`

`Ejemplos`

`$3`

`bash

`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

$3

`bash

`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

$3

`bash

`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

$3

`bash

`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

$3

`bash

`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

$3

`bash

`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

`$3`

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

`bash

`Entrada → Salida normalizada`


"My App"     → "my-app"
"backend_v2" → "backend-v2"
"Front-End!" → "front-end"


Validaciones
La CLI realiza las siguientes validaciones automáticas:

Licencia

GPL-3.0 license

Autor

GitHub | X | Website