Skip to content

README.md

Latest commit

 

History

History
130 lines (101 loc) · 3.05 KB

README.md

File metadata and controls

130 lines (101 loc) · 3.05 KB

🚀 GitHub Repository Manager - Guía de Usuario

✨ ¿Qué hace esta herramienta?

Gestiona todos tus repositorios de GitHub desde la terminal con una interfaz súper visual y colores neón. Puedes ver, clonar, eliminar, exportar y obtener estadísticas de tus repos.

🔑 Configuración Inicial (Solo una vez)

1. Obtener tu Token de GitHub

  1. Ve a: https://github.com/settings/tokens
  2. Click en "Generate new token (classic)"
  3. Selecciona estos permisos:
    • ✅ repo (acceso completo a repositorios)
    • ✅ delete_repo (para eliminar repositorios)
  4. Copia el token generado

2. Configurar la herramienta

python3 andromux.py --setup

Te pedirá:

  • Usuario de GitHub: tu nombre de usuario
  • Token: el token que copiaste

📁 ¿Dónde se guardan los datos?

La herramienta crea carpetas en tu directorio home:

~/.github_actions/
├── config.json     ← Tu usuario y token
├── cache/          ← Datos temporales para ir más rápido
├── exports/        ← Archivos CSV y JSON exportados
└── logs/           ← Registros de actividad

🎮 Comandos Principales

Ver todos tus repositorios

python3 andromux.py --all

Ver solo repositorios públicos

python3 andromux.py --public

Ver solo repositorios privados

python3 andromux.py --private

Ver solo forks

python3 andromux.py --forks

Ver estadísticas completas

python3 andromux.py --all --stats

Clonar repositorios

python3 andromux.py --public --clone

Te mostrará una lista numerada y podrás elegir cuáles clonar.

Exportar datos a Excel/CSV

python3 andromux.py --all --export

Eliminar repositorios (¡CUIDADO!)

python3 andromux.py --forks --delete

🛠️ Herramientas que usa internamente

  • Git: Para clonar repositorios
  • GitHub API: Para obtener información
  • Python requests: Para conectarse a internet
  • CSV/JSON: Para exportar datos

💡 Trucos de Selección

Cuando te pida seleccionar repositorios, puedes usar:

  • Números: 1,3,5,7
  • Rangos: 1-10,15-20
  • Palabras especiales:
    • all = todos
    • public = solo públicos
    • private = solo privados
    • forks = solo forks
    • none = cancelar

🚨 Notas Importantes

  • El token es como tu contraseña: manténlo seguro
  • Eliminar repositorios es IRREVERSIBLE: ten mucho cuidado
  • Los datos se cachean por 5 minutos para ir más rápido
  • Los repositorios clonados se guardan en: ./github_repos/

🆘 Si algo sale mal

Limpiar caché

python3 andromux.py --cache

Reconfigurar credenciales

python3 andromux.py --setup

Ver ayuda completa

python3 andromux.py --help

🎨 ¡Disfruta la experiencia visual!

La herramienta tiene:

  • ✨ Animaciones y barras de progreso
  • 🌈 Colores neón espectaculares
  • ⚡ Interfaz súper rápida y moderna
  • 📊 Estadísticas detalladas y visuales

¡Ya estás listo para gestionar tus repositorios como un pro! 🚀