Primer commit: subida inicial del proyecto

This commit is contained in:
2025-08-16 01:39:09 -03:00
commit 3186a82e48
2 changed files with 262 additions and 0 deletions

153
README.md Normal file
View File

@ -0,0 +1,153 @@
# Gestor de Sesiones TMUX
![Bash](https://img.shields.io/badge/Shell-Bash-green)
![TMUX](https://img.shields.io/badge/Terminal-TMUX-blue)
![License](https://img.shields.io/badge/License-MIT-lightgrey)
Script interactivo para gestionar sesiones de **tmux** con opciones predefinidas y personalizadas.
## 📌 Tabla de Contenidos
- [Características](#-características)
- [Requisitos](#-requisitos)
- [Instalación](#-instalación)
- [Uso](#-uso)
- [Opciones](#-opciones)
- [Ejemplos](#-ejemplos)
- [Capturas](#-capturas)
- [Solución de Problemas](#-solución-de-problemas)
- [Contribuciones](#-contribuciones)
- [Licencia](#-licencia)
## 🌟 Características
- Menú interactivo fácil de usar.
- Opciones predefinidas (**Gemini Nahuel**, **Nahuel**).
- Opción para nombres personalizados.
- Selección de ruta de trabajo para sesiones específicas.
- Verificación automática de existencia de sesiones.
- Manejo de errores con mensajes claros.
## 📋 Requisitos
- **Bash** (v4.0+)
- **TMUX** (v3.0+)
- Sistemas basados en Unix (Linux, macOS)
### Instalación de tmux
```bash
# Debian/Ubuntu
sudo apt install tmux
# RedHat/CentOS
sudo yum install tmux
```
## 🔧 Instalación
1. Descarga el script:
```bash
wget https://ejemplo.com/remoto.sh
```
2. Hazlo ejecutable:
```bash
chmod +x remoto.sh
```
3. (Opcional) Mueve a tu PATH:
```bash
sudo mv remoto.sh /usr/local/bin/remoto
```
## 🚀 Uso
Ejecutar directamente:
```bash
./remoto.sh
```
Si lo moviste a tu PATH:
```bash
remoto
```
## âš™ï¸ Opciones
El script presenta un menú interactivo con:
- **Iniciar sesión**
- Gemini Nahuel (con selector de ruta)
- Nahuel
- Personalizado
- **Reanudar sesión**
- Mismas opciones que iniciar
- **Salir**
## 📖 Ejemplos
Iniciar sesión Gemini Nahuel en una ruta:
```
> 1 (Iniciar)
> 1 (Gemini Nahuel)
> ~/proyectos
```
Reanudar sesión Nahuel:
```
> 2 (Reanudar)
> 2 (Nahuel)
```
### Uso Avanzado
Ejecución con parámetros (modo no interactivo):
```bash
# Iniciar sesión directamente
./remoto.sh --new Gemini-Nahuel --path ~/docs
# Reanudar sesión
./remoto.sh --attach Nahuel
```
Ver todas las sesiones disponibles:
```bash
tmux ls
```
Eliminar una sesión:
```bash
tmux kill-session -t nombre-sesion
```
### Atajos útiles en tmux
- `Ctrl+b d` → Desconectar sesión
- `Ctrl+b $` → Renombrar sesión
📌 Para rutas con espacios, usa comillas:
```bash
"/ruta/con espacios/en/el/nombre"
```
📌 Puedes combinar con SSH:
```bash
ssh usuario@servidor -t "remoto"
```
## 📸 Capturas
```
----------------------------------------
GESTOR DE SESIONES TMUX - BY NAHUEL
----------------------------------------
1) Iniciar sesión
2) Reanudar sesión
3) Salir
Elige una opción (1-3):
```
## ðŸ› ï¸ Solución de Problemas
| Error | Solución |
|------------------------------|----------|
| Permiso denegado | Ejecuta `chmod +x tmux_session_manager.sh` |
| Ruta no existe | Verifica la ruta con `ls` |
| Sesión no existe | Crea una nueva sesión |
| Comando tmux no encontrado | Instala tmux: `sudo apt install tmux` |
## 🤠Contribuciones
¡Las contribuciones son bienvenidas! Puedes abrir un **issue** o enviar un **pull request**.
## 📜 Licencia
Este proyecto está bajo la licencia [MIT](LICENSE).