Primer commit: subida inicial del proyecto
This commit is contained in:
153
README.md
Normal file
153
README.md
Normal file
@ -0,0 +1,153 @@
|
||||
# Gestor de Sesiones TMUX
|
||||
|
||||

|
||||

|
||||

|
||||
|
||||
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).
|
Reference in New Issue
Block a user