remoto_tmux/README.md

# 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).