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 ou use seu gerenciador de pacotes.

# Check if installed
node --version

tmux

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

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

# macOS
brew install cloudflared

# Linux - see cloudflare.com/downloads

Baixar cloudflared

Executar Termbridge

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:

# 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

Dicas para usar Termbridge em celulares e tablets

Vários terminais

Execute várias sessões e alterne entre elas

Visualização do servidor de desenvolvimento

Visualize seu app Vite junto ao terminal

CLI Referência

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