commitmsg-codex

Generate professional Conventional Commit messages from your Git diff using Codex.

Requisitos

• Node.js >= 18
• Git
• Codex CLI instalado y autenticado

Instalación

npm install -g commitmsg-codex

Uso

git add .
commitmsg

Si existen cambios staged, commitmsg analiza git diff --cached. Si no hay cambios staged, analiza git diff.

Opciones

commitmsg --help
commitmsg --plain
commitmsg --copy
commitmsg --en
commitmsg --staged
commitmsg --unstaged

• --help: muestra ayuda de uso.
• --plain: imprime solo el mensaje, sin caja visual.
• --copy: copia el mensaje generado al portapapeles.
• --en: genera el mensaje de commit en inglés. Por defecto, el mensaje se genera en español.
• --staged: analiza solo cambios staged.
• --unstaged: analiza solo cambios unstaged.

La herramienta no hace commit automáticamente, no ejecuta git add, no modifica archivos y no hace push. Solo genera el mensaje de commit.

Ejemplo de salida

fix(auth): corrige validación de sesión expirada

Con --en:

fix(auth): handle expired session validation

Desarrollo

npm link
npm pack --dry-run
npm publish

• npm link: instala este paquete de forma global desde la carpeta local. Sirve para probar el comando commitmsg en la terminal sin publicar el paquete en npm.
• npm pack --dry-run: simula la creación del paquete que se publicaría en npm, pero no genera ni sube nada. Muestra qué archivos entrarían en el paquete según package.json, especialmente la propiedad files.
• npm publish: publica el paquete en el registro de npm. Antes de ejecutarlo conviene revisar la versión en package.json, probar el comando localmente y validar el contenido con npm pack --dry-run.

Licencia

MIT