Repolode
carloscuesta

carloscuesta/gitmoji-cli

Cliente interactivo de línea de comandos para escribir mensajes de commit con prefijos emoji de gitmoji.

Estrellas
4,829
Forks
212
Issues abiertos
18
Último commit
hace 5 días

¿Qué es?

gitmoji-cli es un cliente de línea de comandos para la convención gitmoji, que etiqueta los mensajes de commit con un emoji que indica el tipo de cambio. En lugar de buscar a mano en la lista de gitmoji, puedes explorarla, buscar y elegir un emoji desde la terminal; la herramienta crea el mensaje de commit a partir de tus respuestas a las indicaciones.

La herramienta ofrece dos formas de hacer commits: el modo cliente (`gitmoji -c`), que muestra las indicaciones y hace el commit directamente, y el modo hook (`gitmoji -i`), que se integra con `git commit` para mostrar las indicaciones cada vez que haces un commit. También puedes usar comandos para listar todos los gitmojis, buscarlos por palabra clave y sincronizar la lista con el repositorio de origen. Una caché local permite usar la lista sin conexión.

El comportamiento se puede configurar mediante una clave `gitmoji` en package.json, un archivo `.gitmojirc.json` o un ajuste global. Entre las opciones están ejecutar `git add` automáticamente, elegir el formato del emoji (código o emoji), mostrar indicaciones opcionales para el mensaje y el ámbito con ámbitos predefinidos, y definir una URL personalizada para la API de gitmojis. Se instala con npm o Homebrew.

Funciones clave

  • 01Elegir un gitmoji de forma interactiva y crear un mensaje de commit a partir de las indicaciones.
  • 02Funciona en modo cliente o como hook de `git commit`.
  • 03Lista y permite buscar todos los gitmojis disponibles desde la terminal.
  • 04Funciona sin conexión gracias a una caché local y permite sincronizar la lista cuando se solicite.
  • 05Se configura mediante package.json, .gitmojirc.json o ajustes globales.

Casos de uso

  • Mantener un historial de commits coherente en un equipo que sigue la convención gitmoji.
  • Evitar tener que buscar manualmente códigos de emoji al escribir mensajes de commit.
  • Imponer un formato de commit en un proyecto instalando el hook correspondiente.

Inicio rápido

  1. 1

    Instala gitmoji-cli globalmente con npm

    npm i -g gitmoji-cli
  2. 2

    Inicia el cliente interactivo de commits

    gitmoji -c

Antes de usarlo

  • Usa emojis como prefijos, por lo que solo es adecuado para equipos que siguen la convención gitmoji.

En colecciones

Temas

#git#commit#cli#emoji#conventional-commits#developer-workflow#gitmoji#gitmoji-cli

Preguntas frecuentes

¿Qué es gitmoji-cli?
Cliente interactivo de línea de comandos para escribir mensajes de commit con prefijos emoji de gitmoji. gitmoji-cli es un cliente de línea de comandos para la convención gitmoji, que etiqueta los mensajes de commit con un emoji que indica el tipo de cambio. En lugar de buscar a mano en la lista de gitmoji, puedes explorarla, buscar y elegir un emoji desde la terminal; la herramienta crea el mensaje de commit a partir de tus respuestas a las indicaciones.
¿gitmoji-cli es gratuito? ¿Qué licencia tiene?
gitmoji-cli es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿gitmoji-cli sigue mantenido?
Mantenimiento activo. El último commit de gitmoji-cli fue el 2 nov 2026.
¿Para qué puedo usar gitmoji-cli?
Mantener un historial de commits coherente en un equipo que sigue la convención gitmoji. Evitar tener que buscar manualmente códigos de emoji al escribir mensajes de commit. Imponer un formato de commit en un proyecto instalando el hook correspondiente.
¿Cómo se instala gitmoji-cli?
Instala gitmoji-cli globalmente con npm: npm i -g gitmoji-cli Inicia el cliente interactivo de commits: gitmoji -c
¿Dónde consigo gitmoji-cli?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/carloscuesta/gitmoji-cli

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

Proyectos relacionados