Saltar al contenido

Varios terminales

Ver como Markdown Editar en GitHub Documentación de 1675df8

Termbridge puede ejecutar varias sesiones de terminal simultáneamente. Un servidor aloja varias sesiones de tmux y el UI te permite cambiar entre ellas.

Cómo funciona

  • Termbridge registra las sesiones que ha creado o a las que se ha conectado durante la ejecución actual
  • El selector de terminal muestra todas las sesiones disponibles
  • El cambio es instantáneo: no hace falta volver a conectarse

Crear varias sesiones

Al iniciar

Usa la variable de entorno TERMBRIDGE_SESSIONS:

Shell
TERMBRIDGE_SESSIONS=3 npx termbridge

Esto crea tres sesiones: <base>, <base>-2 y <base>-3.

Durante el desarrollo

Usa el script de acceso directo:

Shell
bun run dev:beam:multi

Mientras Termbridge está en ejecución

El UI permite cambiar entre terminales, pero no ofrece una opción para crear uno. Para tener más terminales, reinicia Termbridge con un valor TERMBRIDGE_SESSIONS más alto o abre ventanas adicionales dentro de la propia sesión tmux (Ctrl+B y luego c).

Cambiar de terminal

  1. Toca el icono del terminal en la barra inferior
  2. Aparecerá una lista de las sesiones disponibles
  3. Toca una para cambiar a ella

El cambio es instantáneo: la sesión anterior sigue ejecutándose en segundo plano.

Casos de uso

Compilación y registros

Ejecuta la compilación en un terminal y sigue los registros en otro:

Shell
# Terminal 1: Build
npm run build

# Terminal 2: Logs
tail -f logs/app.log

Cambia de uno a otro sin perder el hilo.

Servidor y cliente

Ejecuta el servidor de backend en un terminal y el servidor de desarrollo del frontend en otro:

Shell
# Terminal 1: Backend
npm run server

# Terminal 2: Frontend
npm run dev

Varias sesiones de SSH

Conéctate a distintos servidores:

Shell
# Terminal 1
ssh user@server1.com

# Terminal 2
ssh user@server2.com

Supervisa ambos desde el teléfono.

Nombres de sesión

De forma predeterminada, las sesiones se nombran según el número de puerto. Usa --session para asignarles nombres descriptivos:

Shell
termbridge --session api-server

Al crear varias sesiones con TERMBRIDGE_SESSIONS, se usa el nombre base con sufijos numéricos.

Persistencia

  • Las sesiones persisten al desconectarte de UI
  • Las sesiones persisten cuando se reinicia Termbridge (salvo que --kill-on-exit)
  • Usa --session <name> para volver a conectarte a una sesión existente