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

No packages published