Repolode
Everduin94

Everduin94/better-commits

CLI en TypeScript que te guía para escribir mensajes de Conventional Commits, infiere datos a partir de la rama y ofrece utilidades para ramas y worktrees.

Estrellas
2,284
Forks
80
Issues abiertos
6
Último commit
hace 2 meses

¿Qué es?

better-commits es una herramienta de línea de comandos que crea mensajes de commit de Git según la especificación Conventional Commits. En lugar de escribir el formato manualmente, respondes una serie de preguntas sobre el tipo de commit, el scope, el ticket, el título, el cuerpo y los footers; después puedes previsualizar el resultado antes de crear el commit.

La herramienta infiere el número de ticket, el tipo de commit y el scope a partir del nombre de la rama actual, así que completa automáticamente los valores habituales. Su configuración se guarda en un archivo .better-commits.jsonc que puede definirse de forma global o por repositorio, e incluye la lista de tipos, los emojis, los límites de longitud del título y más. El comando complementario better-branch crea ramas o worktrees con nombres de formato coherente y puede ejecutar hooks antes y después.

Para automatizar tareas, el modo --no-interactive, junto con las opciones de CLI, permite que los scripts y los agentes de programación generen commits sin preguntas interactivas; además, --dry-run valida el comando de commit de Git resultante.

Funciones clave

  • 01Crea mensajes de Conventional Commits mediante preguntas guiadas y permite previsualizarlos antes de confirmar el commit
  • 02Infiere el ticket, el scope y el tipo de commit a partir del nombre de la rama
  • 03Se puede configurar de forma global o por repositorio mediante un archivo de configuración JSONC
  • 04Crea ramas o worktrees con nombres coherentes mediante better-branch
  • 05Modo no interactivo con opciones de CLI para scripts y agentes de programación

Casos de uso

  • Mantener un historial de commits coherente en equipos que siguen Conventional Commits
  • Completar automáticamente los campos de ticket y scope a partir de nombres de rama como feature/TICKET-123-description
  • Permitir que los agentes de programación con IA generen mensajes de commit estandarizados sin preguntas interactivas
  • Crear worktrees de Git para cada rama de funcionalidad con nombres de carpeta predecibles

Inicio rápido

  1. 1

    Instala la CLI globalmente con npm (requiere Node.js 20 o posterior)

    npm install -g better-commits
  2. 2

    Ejecuta la CLI en tu repositorio para crear un commit

    better-commits

Antes de usarlo

  • Requiere Node.js 20 o posterior.

Temas

Preguntas frecuentes

¿Qué es better-commits?
CLI en TypeScript que te guía para escribir mensajes de Conventional Commits, infiere datos a partir de la rama y ofrece utilidades para ramas y worktrees. better-commits es una herramienta de línea de comandos que crea mensajes de commit de Git según la especificación Conventional Commits. En lugar de escribir el formato manualmente, respondes una serie de preguntas sobre el tipo de commit, el scope, el ticket, el título, el cuerpo y los footers; después puedes previsualizar el resultado antes de crear el commit.
¿better-commits es gratuito? ¿Qué licencia tiene?
better-commits es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿better-commits sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de better-commits fue el 26 ago 2026.
¿Para qué puedo usar better-commits?
Mantener un historial de commits coherente en equipos que siguen Conventional Commits Completar automáticamente los campos de ticket y scope a partir de nombres de rama como feature/TICKET-123-description Permitir que los agentes de programación con IA generen mensajes de commit estandarizados sin preguntas interactivas Crear worktrees de Git para cada rama de funcionalidad con nombres de carpeta predecibles
¿Cómo se instala better-commits?
Instala la CLI globalmente con npm (requiere Node.js 20 o posterior): npm install -g better-commits Ejecuta la CLI en tu repositorio para crear un commit: better-commits
¿Dónde consigo better-commits?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/Everduin94/better-commits

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados