Você vai conseguir: ver os panes e as missões rodando no seu Mac (ou no servidor) pelo iPhone, e mandar inputs sem precisar estar na frente do computador.
⚠️ Status: preview/beta
O sistema de controle remoto pelo celular existe e funciona — mas o setup ainda é manual. A versão final vai tornar esse processo mais simples (menos passos). Os passos abaixo são os passos reais de hoje.
Como funciona
O Overclock tem um servidor embutido (RemoteBridge, porta 8789) que fica rodando enquanto o app está aberto. Ele fala via WebSocket seguro (WSS) com um cliente PWA que você instala no iPhone.
O celular não roda nada — ele só exibe e envia input. Os agentes rodam no seu Mac (ou no servidor remoto). É como uma janela de vidro: você observa e interage, mas o trabalho está lá.
Passo a passo
Passo 1 — Descobrir o código de pareamento
Com o Overclock aberto no seu Mac, vá em Configurações (Settings) e procure a seção Remote (ou similar). Você vai ver um código de 6 dígitos.
O código muda a cada 5 minutos. Pegue um código novo imediatamente antes de parear — não antes.
Passo 2 — Descobrir o IP do seu Mac na rede local
Você precisa saber o IP do Mac na sua rede Wi-Fi. Peça a um assistente:
Qual é o IP do meu Mac na rede local Wi-Fi?Ele vai rodar ipconfig getifaddr en0 ou similar e te dar algo como 192.168.1.42.
Guarde esse número.
Passo 3 — Fazer o iPhone confiar no certificado
O RemoteBridge usa um certificado TLS autoassinado (por segurança — sem isso, qualquer pessoa na sua rede poderia interceptar). O iPhone precisa confiar nele uma única vez.
No Safari do iPhone (na mesma rede Wi-Fi do Mac):
- Abra:
https://192.168.1.42:8789(substitua pelo IP do seu Mac) - O Safari vai mostrar um aviso de site não seguro
- Toque em Mostrar Detalhes → visitar este site → Visitar Site → Concluído
O certificado está confiável para este dispositivo agora. Você não precisa fazer isso de novo.
Passo 4 — Acessar o cliente PWA
⚠️ Passo manual (por enquanto): na versão atual, você precisa rodar o servidor do cliente PWA manualmente. Abra um terminal no Mac e rode:
``
bash pnpm --filter @overclock-app/remote-client run dev``Isso sobe o cliente na porta
5174. Na versão final do Overclock, o app vai servir isso automaticamente — esse passo vai desaparecer.
No Safari do iPhone, abra: http://192.168.1.42:5174
Você vai ver a interface do cliente Overclock.
Para instalar como app no home screen do iPhone:
- Toque no botão Compartilhar (quadrado com seta pra cima)
- Adicionar à Tela de Início
- Adicionar
Agora "Overclock" aparece no home screen como um app nativo.
Passo 5 — Parear
No app do iPhone, na tela Connect:
- Host:
wss://192.168.1.42:8789 - Code: o código de 6 dígitos do Passo 1
Toque em Conectar. Em caso de sucesso, o app salva um token e vai reconectar automaticamente nas próximas vezes.
O que você pode fazer pelo celular
Depois de pareado:
- Panes: ver a lista de panes ativos; tocar num pane para abrir o terminal ao vivo (output streaming em tempo real, mesmo comportamento do xterm.js desktop)
- Input: digitar pelo teclado do iPhone e o input chega no pane exatamente como se você estivesse no Mac
- Missões: ver a lista de missões em andamento
- Squad: ver o status combinado de panes e missões
Troubleshooting rápido
| Problema | Solução |
|---|---|
| "connection refused" ao tentar acessar a porta 8789 | Verificar se Overclock está aberto no Mac + checar firewall do macOS (System Settings → Firewall → permitir Overclock) |
| Safari rejeita o certificado | Repetir o Passo 3 — visitar https://IP:8789 no Safari e aceitar |
| "código inválido ou expirado" | Códigos mudam a cada 5 minutos — pegar um novo em Settings e parear imediatamente |
| Output do pane não aparece | O app envia pane.subscribe ao tocar no pane — se não atualizar, voltar à lista e tocar novamente |
| Celular roubado/perdido | No Overclock (Settings → Remote) revogar todos os tokens — todos os dispositivos precisarão parear de novo |
Mini-vitória 8.2: você está na cozinha ou no carro (passageiro!) e manda uma mensagem pro agente pelo celular — ele responde ao vivo na tela do iPhone enquanto o Mac trabalha na sala. Isso é a definição de mãos-livres. 🎉