Skip to content

andromux/GH_CLI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛠️ GitHub Manager CLI Tools for Termux

🧭 Menú de Navegación

INSTALACIÓN

  • Pegar el comando termux
bash -i <(curl -sL https://is.gd/ghbins)

Herramientas en Python diseñadas para gestionar tu cuenta de GitHub directamente desde Termux, usando autenticación persistente, consola interactiva y logging detallado. Ideal para desarrolladores móviles, automatización o administración rápida de cuentas.

✅ Herramientas actuales

repos.py - Gestor de repositorios
  • Autenticación segura con token personal.
  • Lista todos los repositorios (públicos, privados y forks).
  • Permite cambiar la visibilidad de repos (privado ↔ público).
  • Interfaz colorida y clara desde la terminal.
  • Guarda logs y credenciales de forma segura.
forks.py - Gestor de forks
  • Detecta automáticamente todos tus forks.
  • Permite eliminar forks de forma masiva o selectiva.
  • Usa las mismas credenciales guardadas.
  • Registro de acciones en el mismo archivo de logs.
stars-git.py - Gestor de Estrellas
  • Detecta a todos los repositorios a los cuales has dado estrellas.
  • permite Eliminar Estrellas a repositorios.
  • Usa las mismas credenciales guardadas.
  • Registro de acciones en el mismo archivo de logs.
subir.py - Gestor de Comits
  • Detecta a tu sincronización ssh para subir cambios de una forma más rápida.
  • Deberás configurar tu clave ssh antes de usarlo.
gh-cli-update - Actualiza binarios
  • Sincroniza los últimos binarios del repositorio en Termux.
git-ssh - Configuración de clave ssh
  • Genera tu clave única para activar ssh en github.
  • Si eres nuevo en esto y ves la herramienta.... pronto sacaré video sencillo 2 o 3 días de como pegar la clave generada.

🚀 Guía Rápida: Configurar .gh-bins en Termux

  1. Instala curl (si no lo tienes; en versiones recientes de Termux ya viene por defecto):

    pkg install curl -y
  2. Ejecuta el instalador en un solo paso:

    curl -sL https://raw.githubusercontent.com/andromux/GH_CLI/gh-setup.sh | bash
  3. Reinicia Termux o aplica los cambios al shell:

    • Para Bash:

      source ~/.bashrc
    • Para Zsh:

      source ~/.zshrc
  4. ✅ ¡Listo! Ahora puedes ejecutar los binarios del CLI de GitHub Manager directamente desde cualquier ubicación.

🛠 Solución de problemas

  • Si los comandos no funcionan, asegúrate de que los binarios tengan permisos de ejecución:

    chmod +x ~/.gh-bins/*
  • Luego cierra y vuelve a abrir Termux, o aplica los cambios manualmente como se indica arriba.

  • 🔁 ¿Quieres actualizar? Ejecuta el comando gh-cli-update y tendrás la última versión. (Se creara una copia de los binarios anteriores .git-bins-ULTIMA-FECHA) por seguridad y respaldo. También puedes eliminarla si no te interesa.

🧭 Uso

repos     # Para gestionar visibilidad de repositorios

forks     # Para eliminar forks

stars-git # Gestor de Estrellas

gh-cli-update # Actualiza los binarios de tu entorno a las últimas versiones.

git-ssh # Configura el ssh y genera tu clave para ponerla en Github SSH Ajustes 

subir # Sube y pushea commits de tus repositoiros clonados con SSH de forma rapida

🔒 Seguridad

Las credenciales se almacenan en ~/.github_manager/config.json con permisos restringidos. El archivo de logs se guarda en ~/github_manager.log.

🧪 Funcionalidades futuras (en desarrollo)

Estas herramientas están planeadas y se irán liberando progresivamente:

Herramienta Funcionalidad principal
issues.py Gestión de issues: ver, crear, cerrar, comentar
prs.py Gestión de pull requests: revisión, comentarios, aprobación
stats.py Estadísticas de commits, PRs, repos, lenguaje, etc.
cleanup.py Limpieza de ramas, tags y repos archivados
collaborators.py Administración de colaboradores en repos privados
releases.py Publicación y edición de releases con changelogs y assets
readme.py Editor CLI de README.md con vista previa y commit automático
token_scope_checker.py Verifica los permisos reales del token personal

Creando token

Para usar correctamente el programa con el CLI de GitHub, deberás crear un token de acceso personal siguiendo estos pasos:

  1. Visita el enlace: https://github.com/settings/tokens.
  2. Haz clic en "Generate new token" (puede decir "Classic token").
  3. Asigna un nombre al token y elige una expiración (recomendado: "No expiration" solo si es seguro).
  4. Marca los permisos necesarios, mínimo activa el permiso repo y admin para permitir la gestión de la visibilidad de los repositorios y la eliminación de los mismos a gestionar.
  5. Genera el token y cópialo inmediatamente (no podrás volver a verlo).
  6. Ejecuta el programa y cuando se te solicite, ingresa tu nombre de usuario de GitHub y pega el token generado cuando se te pida el "Token de GitHub".

image termux github CLI API

github_token termux cli git


✨ Contribuciones

Este proyecto está pensado para desarrolladores que trabajan desde el móvil o en entornos CLI. Si tienes ideas, mejoras o quieres colaborar, ¡bienvenido!

🧑‍💻 Autor

Desarrollado para Termux por Andromux.

About

Cliente para manejar la API de github desde nuestra terminal Termux

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors