# Primeiros passos

## Instalar os pré-requisitos

Para a configuração padrão com túnel local, instale estas ferramentas no computador:

### Node.js 20+

Baixe em [nodejs.org](https://nodejs.org) ou use seu gerenciador de pacotes.

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

### tmux

O multiplexador de terminais que alimenta as sessões Termbridge.

```bash
# macOS
brew install tmux

# Ubuntu/Debian
sudo apt install tmux
```

### cloudflared

Cria o túnel seguro até seu terminal (não é necessário no modo direto de sandbox).

```bash
# macOS
brew install cloudflared

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

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


## Executar Termbridge

```bash
npx termbridge
```

Você verá uma saída como esta:

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

> **Observação**
> O túnel `trycloudflare.com` URL é rápido e não exige uma conta. Se você usa Termbridge com frequência,
> configure um token de túnel nomeado Cloudflare para evitar limites de uso.


## Conectar pelo celular

1. Abra a câmera do celular
2. Aponte-a para o código QR
3. Toque no link exibido
4. Seu terminal será carregado no navegador

Pronto: você está conectado!

## O que acabou de acontecer?

1. Termbridge iniciou um servidor local na sua máquina
2. Criou uma sessão tmux para seu terminal
3. Cloudflare criou um túnel seguro (o `trycloudflare.com` URL)
4. O código QR contém um token de uso único para acesso seguro. Ele só pode ser usado uma vez e expira 90 segundos após a inicialização; leia-o logo. Se tiver expirado, reinicie Termbridge para gerar outro
5. Ao ler o código, você recebeu um cookie de sessão e se conectou

## Experimente

Depois de se conectar, experimente alguns comandos:

```bash
# See system info
htop

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

# Run any CLI tool
```

O terminal oferece suporte a todas as cores, TUIs e teclas que você espera.

## Manter em execução

Termbridge precisa continuar em execução para que a conexão funcione. Quando terminar:

- Pressione `Ctrl+C` no terminal em que Termbridge está em execução
- O túnel será fechado e a conexão encerrada
- Sua sessão tmux continuará ativa (a menos que você tenha usado `--kill-on-exit`)

## Comportamento da primeira sessão

- Termbridge cria uma sessão tmux (o nome padrão é derivado da porta)
- O primeiro terminal da lista é carregado automaticamente
- Você pode criar várias sessões na inicialização definindo `TERMBRIDGE_SESSIONS=2`

## Usar uma sessão tmux existente

Se você passar `--session <name>` e essa sessão já existir, Termbridge se conectará a ela em vez de criar uma nova. Isso é útil para monitorar processos de longa duração que você já iniciou.

## Próximas etapas

### [Controles para celular](https://termbridge.inline0.dev/pt/docs/usage/mobile-controls)

Dicas para usar Termbridge em celulares e tablets

### [Vários terminais](https://termbridge.inline0.dev/pt/docs/usage/multiple-terminals)

Execute várias sessões e alterne entre elas

### [Visualização do servidor de desenvolvimento](https://termbridge.inline0.dev/pt/docs/usage/dev-server-preview)

Visualize seu app Vite junto ao terminal

### [CLI Referência](https://termbridge.inline0.dev/pt/docs/cli)

Consulte todas as opções e sinalizadores disponíveis