# Primeros pasos

## Instalar los requisitos previos

Para la configuración predeterminada del túnel local, instala estas herramientas en el equipo:

### Node.js 20+

Descárgalo desde [nodejs.org](https://nodejs.org) o usa tu gestor de paquetes.

```bash
# Check if installed
node --version
```

### tmux

El multiplexor de terminales que impulsa las sesiones de Termbridge.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

### cloudflared

Crea el túnel seguro hasta tu terminal (no se necesita para el modo directo de sandbox).

```bash
# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads
```

[Descargar cloudflared](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/)


## Ejecutar Termbridge

```bash
npx termbridge
```

Verás una salida como esta:

```
┌─────────────────────────────────────────┐
│  Termbridge                             │
│                                         │
│  Local:   http://127.0.0.1:51234        │
│  Public:  https://abc123.trycloudflare.com │
│                                         │
│  ██████████████                         │
│  ██          ██  <- Scan this QR code   │
│  ██████████████                         │
│                                         │
└─────────────────────────────────────────┘
```

> **Nota**
> El `trycloudflare.com` URL es un túnel rápido que no requiere cuenta. Si usas Termbridge con frecuencia,
> configura un token de túnel con nombre de Cloudflare para evitar los límites de solicitudes.


## Conectarse desde el teléfono

1. Abre la cámara del teléfono
2. Apúntala al código QR
3. Toca el enlace que aparece
4. La terminal se abrirá en el navegador

Eso es todo: ¡ya estás conectado!

## ¿Qué acaba de pasar?

1. Termbridge inició un servidor local en tu equipo
2. Creó una sesión de tmux para tu terminal
3. Cloudflare creó un túnel seguro (el `trycloudflare.com` URL)
4. El código QR contiene un token de un solo uso para acceder de forma segura. Funciona una vez y caduca 90 segundos después del inicio, así que escanéalo enseguida; si ha caducado, reinicia Termbridge para generar otro
5. Al escanearlo, obtuviste una cookie de sesión y te conectaste

## Pruébalo

Una vez conectado, prueba algunos comandos:

```bash
# See system info
htop

# Check a git repo
cd ~/your-project && git status

# Run any CLI tool
```

La terminal admite colores completos, TUI y todas las teclas habituales.

## Mantenerlo en ejecución

Termbridge debe seguir ejecutándose para que funcione la conexión. Cuando termines:

- Pulsa `Ctrl+C` en la terminal donde se está ejecutando Termbridge
- El túnel se cierra y la conexión termina
- La sesión de tmux sigue activa (salvo que hayas usado `--kill-on-exit`)

## Comportamiento de la primera sesión

- Termbridge crea una sesión de tmux (el nombre predeterminado se deriva del puerto)
- La primera terminal de la lista se carga automáticamente
- Puedes crear varias sesiones al iniciar si defines `TERMBRIDGE_SESSIONS=2`

## Usar una sesión de tmux existente

Si pasas `--session <name>` y esa sesión ya existe, Termbridge se conectará a ella en lugar de crear una nueva. Esto resulta útil para supervisar procesos de larga duración que ya hayas iniciado.

## Pasos siguientes

### [Controles móviles](https://termbridge.inline0.dev/es/docs/usage/mobile-controls)

Consejos para usar Termbridge en teléfonos y tabletas

### [Varias terminales](https://termbridge.inline0.dev/es/docs/usage/multiple-terminals)

Ejecuta varias sesiones y alterna entre ellas

### [Vista previa del servidor de desarrollo](https://termbridge.inline0.dev/es/docs/usage/dev-server-preview)

Previsualiza tu aplicación de Vite junto a la terminal

### [Referencia de CLI](https://termbridge.inline0.dev/es/docs/cli)

Consulta todas las opciones y marcas disponibles