|
| 1 | +# 🚀 GitHub Repository Manager - Guía de Usuario |
| 2 | + |
| 3 | +## ✨ ¿Qué hace esta herramienta? |
| 4 | + |
| 5 | +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. |
| 6 | + |
| 7 | +## 🔑 Configuración Inicial (Solo una vez) |
| 8 | + |
| 9 | +### 1. Obtener tu Token de GitHub |
| 10 | +1. Ve a: **https://github.com/settings/tokens** |
| 11 | +2. Click en **"Generate new token (classic)"** |
| 12 | +3. Selecciona estos permisos: |
| 13 | + - ✅ `repo` (acceso completo a repositorios) |
| 14 | + - ✅ `delete_repo` (para eliminar repositorios) |
| 15 | +4. Copia el token generado |
| 16 | + |
| 17 | +### 2. Configurar la herramienta |
| 18 | +```bash |
| 19 | +python3 andromux.py --setup |
| 20 | +``` |
| 21 | +Te pedirá: |
| 22 | +- **Usuario de GitHub:** tu nombre de usuario |
| 23 | +- **Token:** el token que copiaste |
| 24 | + |
| 25 | +## 📁 ¿Dónde se guardan los datos? |
| 26 | + |
| 27 | +La herramienta crea carpetas en tu directorio home: |
| 28 | +``` |
| 29 | +~/.github_actions/ |
| 30 | +├── config.json ← Tu usuario y token |
| 31 | +├── cache/ ← Datos temporales para ir más rápido |
| 32 | +├── exports/ ← Archivos CSV y JSON exportados |
| 33 | +└── logs/ ← Registros de actividad |
| 34 | +``` |
| 35 | + |
| 36 | +## 🎮 Comandos Principales |
| 37 | + |
| 38 | +### Ver todos tus repositorios |
| 39 | +```bash |
| 40 | +python3 andromux.py --all |
| 41 | +``` |
| 42 | + |
| 43 | +### Ver solo repositorios públicos |
| 44 | +```bash |
| 45 | +python3 andromux.py --public |
| 46 | +``` |
| 47 | + |
| 48 | +### Ver solo repositorios privados |
| 49 | +```bash |
| 50 | +python3 andromux.py --private |
| 51 | +``` |
| 52 | + |
| 53 | +### Ver solo forks |
| 54 | +```bash |
| 55 | +python3 andromux.py --forks |
| 56 | +``` |
| 57 | + |
| 58 | +### Ver estadísticas completas |
| 59 | +```bash |
| 60 | +python3 andromux.py --all --stats |
| 61 | +``` |
| 62 | + |
| 63 | +### Clonar repositorios |
| 64 | +```bash |
| 65 | +python3 andromux.py --public --clone |
| 66 | +``` |
| 67 | +Te mostrará una lista numerada y podrás elegir cuáles clonar. |
| 68 | + |
| 69 | +### Exportar datos a Excel/CSV |
| 70 | +```bash |
| 71 | +python3 andromux.py --all --export |
| 72 | +``` |
| 73 | + |
| 74 | +### Eliminar repositorios (¡CUIDADO!) |
| 75 | +```bash |
| 76 | +python3 andromux.py --forks --delete |
| 77 | +``` |
| 78 | + |
| 79 | +## 🛠️ Herramientas que usa internamente |
| 80 | + |
| 81 | +- **Git:** Para clonar repositorios |
| 82 | +- **GitHub API:** Para obtener información |
| 83 | +- **Python requests:** Para conectarse a internet |
| 84 | +- **CSV/JSON:** Para exportar datos |
| 85 | + |
| 86 | +## 💡 Trucos de Selección |
| 87 | + |
| 88 | +Cuando te pida seleccionar repositorios, puedes usar: |
| 89 | +- **Números:** `1,3,5,7` |
| 90 | +- **Rangos:** `1-10,15-20` |
| 91 | +- **Palabras especiales:** |
| 92 | + - `all` = todos |
| 93 | + - `public` = solo públicos |
| 94 | + - `private` = solo privados |
| 95 | + - `forks` = solo forks |
| 96 | + - `none` = cancelar |
| 97 | + |
| 98 | +## 🚨 Notas Importantes |
| 99 | + |
| 100 | +- **El token es como tu contraseña:** manténlo seguro |
| 101 | +- **Eliminar repositorios es IRREVERSIBLE:** ten mucho cuidado |
| 102 | +- **Los datos se cachean por 5 minutos** para ir más rápido |
| 103 | +- **Los repositorios clonados se guardan en:** `./github_repos/` |
| 104 | + |
| 105 | +## 🆘 Si algo sale mal |
| 106 | + |
| 107 | +### Limpiar caché |
| 108 | +```bash |
| 109 | +python3 andromux.py --cache |
| 110 | +``` |
| 111 | + |
| 112 | +### Reconfigurar credenciales |
| 113 | +```bash |
| 114 | +python3 andromux.py --setup |
| 115 | +``` |
| 116 | + |
| 117 | +### Ver ayuda completa |
| 118 | +```bash |
| 119 | +python3 andromux.py --help |
| 120 | +``` |
| 121 | + |
| 122 | +## 🎨 ¡Disfruta la experiencia visual! |
| 123 | + |
| 124 | +La herramienta tiene: |
| 125 | +- ✨ Animaciones y barras de progreso |
| 126 | +- 🌈 Colores neón espectaculares |
| 127 | +- ⚡ Interfaz súper rápida y moderna |
| 128 | +- 📊 Estadísticas detalladas y visuales |
| 129 | + |
| 130 | +¡Ya estás listo para gestionar tus repositorios como un pro! 🚀 |
0 commit comments