Git CLI (@asaro/git-cli)

Git CLI interactivo en español para gestionar repositorios Git y GitHub desde la terminal.

Características

• 📋 Estado del repositorio, historial de commits
• ✅ Commit, Push, Pull
• 🌿 Gestión de ramas
• 🔀 Merge y Rebase
• 📦 Stash
• 🆕 Repositorios (clone, init, remotos)
• 🌐 Integración con GitHub
  • Autenticación segura
  • Crear y gestionar repositorios
  • GitHub Actions
• 🔐 Token encriptado guardado localmente

Instalación

Requisitos previos

• Node.js (v18 o superior)
• npm (v9 o superior)
• Git instalado y configurado

Métodos de instalación

1. Instalación global desde npm (la forma más fácil!)

Si el paquete está publicado en npm:

# Instálalo globalmente en tu PC
npm install -g @itzasaro/git-cli

# Ahora puedes usar el comando 'git-cli' desde cualquier lugar!
git-cli

2. Instalación desde el repositorio

Si quieres instalarlo directamente desde el código fuente:

# Clona el repositorio
git clone https://github.com/iTzAsaro/GitCLI.git
cd gitcli

# Instala dependencias y compila
npm install
npm run build

# Instálalo globalmente
npm install -g .

# Ahora puedes usar el comando 'git-cli' desde cualquier lugar!
git-cli

3. Usar desde la carpeta del proyecto

Si prefieres no instalarlo globalmente:

npm install
npm run build
npm start

Publicar tu paquete en npm

Si quieres que otras personas puedan instalarlo con npm install -g gitcli, sigue estos pasos:

Paso 1: Crear una cuenta en npm

1. Ve a https://www.npmjs.com/signup
2. Crea tu cuenta y verifica tu email

Paso 2: Iniciar sesión en npm desde la terminal

npm login

Ingresa tu username, password y email de npm.

Paso 3: Actualizar datos del paquete

Edita package.json y cambia:

• name: Asegúrate de que el nombre esté disponible en npm
• author: Tu nombre y email
• repository: La URL de tu repo en GitHub
• homepage y bugs: URLs de tu repo

Paso 4: Publicar!

Como es un paquete con scope (@iTzAsaro/), necesitas publicar con acceso público:

npm publish --access public

¡Listo! Ahora cualquier persona puede instalar tu paquete con:

npm install -g @itzasaro/git-cli

Para publicar una nueva versión

Siempre que quieras publicar una actualización:

1. Actualiza la versión en package.json (usa Semantic Versioning)
2. Ejecuta:

   npm publish --access public

Uso

Ejecuta el comando y sigue las instrucciones en la terminal:

git-cli

Configuración de GitHub

1. Abre GitCLI
2. Ve a "🌐 Gestión GitHub"
3. Selecciona "Autenticación (Login/Logout)"
4. Ingresa tu Personal Access Token de GitHub
5. ¡Listo para usar todas las funcionalidades de GitHub!

Cómo crear un Personal Access Token:

1. Ve a https://github.com/settings/tokens/new
2. Selecciona los scopes:
   • repo (para repositorios)
   • workflow (para GitHub Actions)
   • delete_repo (para borrar repositorios, opcional)
3. Genera y copia el token

Funcionalidades

Menú principal

• 📋 Estado del repositorio - Ver el estado actual del repo
• 📜 Ver historial (log) - Ver commits y cambios
• ✅ Commit - Hacer commit de cambios
• ↑ Push - Subir cambios a remoto
• ↓ Pull - Bajar cambios de remoto
• 🌿 Ramas - Gestionar ramas
• 🔀 Merge / Rebase - Fusionar cambios
• 📦 Stash - Guardar cambios temporalmente
• 🆕 Repositorio - Clonar, init o gestionar remotos
• 🌐 Gestión GitHub - Gestionar GitHub
• 🚪 Salir - Cerrar la aplicación

Actualización

Si instalaste globalmente y quieres actualizar:

cd gitcli
git pull
npm install
npm run build
npm install -g .

Desinstalación

npm uninstall -g @itzasaro/git-cli

Archivos de configuración

• El token de GitHub se guarda encriptado en ~/.gitcli/

Licencia

ISC