@livrasand/gitbrancher
v1.1.0
Published
CLI para crear ramas Git con nombres estandarizados según el flujo de trabajo.
Maintainers
Readme
Instalación
npm i @livrasand/gitbrancherUso rápido
gitbrancher newComandos principales
gitbrancher new: crea una nueva rama con flujo interactivo. Pregunta por el tipo de rama y descriptor; si detecta credenciales de Azure DevOps, ofrece usar tu backlog.gitbrancher list-types: muestra los tipos de ramas disponibles y su descripción.gitbrancher config: administra alias y credenciales. Usa--alias,--clear-alias,--azure,--clear-azure.gitbrancher help: despliega la ayuda con ejemplos.
Conexión con Azure DevOps
GitBrancher puede consultar tu backlog personal en Azure DevOps para crear ramas basadas en work items.
Configura tus credenciales
gitbrancher config --azureProporciona organización, proyecto y token personal (PAT). El asistente también acepta un equipo específico y tu usuario.
🔐 Seguridad: Las credenciales se almacenan de forma segura en el keychain del sistema operativo (Keychain en macOS, Credential Manager en Windows, libsecret en Linux), protegiendo tu PAT con encriptación del OS.
(Opcional) Variables de entorno Puedes definir
GITBRANCHER_AZURE_ORG,GITBRANCHER_AZURE_PROJECT,GITBRANCHER_AZURE_PAT, etc. como alternativa o complemento al asistente.Ejecuta el flujo interactivo
gitbrancher newSi hay credenciales válidas, se mostrará una lista de work items asignados. Al elegir uno:
- Se sugiere el tipo de rama con base en el tipo de work item (bug → bugfix, feature → feature, etc.).
- El descriptor se prellena con
<ID>-<Título>para agilizar la creación de ramas. - Puedes modificar cualquiera de los campos antes de confirmar.
Resultado Se crea y hace checkout de la rama con formato
<alias>/<tipo>/<descriptor>, lista para trabajar.
Documentación adicional
Consulta la carpeta docs/ para obtener información detallada sobre la arquitectura, configuración y futuras integraciones.
