Procurando o app nativo para Mac? Se você quer executar o agente neste Mac, baixe o App de Desktop nativo — essa é a opção recomendada. Esta página é sobre usar o cliente iOS em um Mac para controlar um agente rodando em outro computador.
Visão Geral
O app iOS do Btelo Coding pode ser executado em Mac com Apple Silicon (M1, M2, M3, M4) — a App Store permite instalar o mesmo binário iOS diretamente. Você tem exatamente as mesmas sessões, chat e controles do iPhone — rodando nativamente em uma janela de desktop com teclado físico. Ele funciona como cliente, apontando para um agente rodando em outro lugar (seu app de desktop, um agente CLI ou um VPS).
Não há um código Mac separado para este cliente. O cliente Mac é o app iOS.
O que você recebe no Mac:
- Paridade de recursos quase completa com o iOS. Navegar arquivos, conversar, conduzir sessões, trocar de provedores de IA, gerenciar conectores e crons — quase todos os recursos do iOS funcionam igual no Mac.
- Ajustado para entrada de desktop. Atalhos de teclado físico, rolagem com trackpad, redimensionamento livre de janela e copiar/colar se comportam como esperado em um app de desktop, não em um celular.
- Sincronização em tempo real com o iPhone. O estado de chat e sessão é transmitido pelo relay em tempo real. Envie uma mensagem no Mac, veja ela chegar no iPhone instantaneamente — troque de dispositivo no meio de uma conversa sem perder o contexto.
- Entre máquinas, entre redes. O app Mac controla qualquer agente que o relay possa alcançar: seu computador em casa, um VPS, a máquina de um colega, em redes diferentes ou cidades diferentes. Troque entre Wi-Fi, cabo e hotspot durante a sessão — o relay mantém a conexão ativa.
- Além do terminal puro. Comparado a executar o Claude ou Codex diretamente no terminal, cada mensagem de chat fica sincronizada entre Mac e iPhone, e você pode gerenciar múltiplos diretórios de trabalho e múltiplas sessões em janelas separadas lado a lado.
Requisitos
- Um Mac com Apple Silicon (Macs Intel não podem instalar apps iOS pela App Store)
- macOS 11 Big Sur ou posterior
- Um Apple ID conectado à App Store
Instalar em Quatro Passos
- Abra a App Store no seu Mac (Dock ou Launchpad).
- Pesquise por
Btelo Coding. - Nos resultados, alterne para a aba iPhone & iPad Apps. É lá que ficam os apps iOS no Mac.
- Clique em Obter e instale. O app aparece na sua pasta Aplicativos e no Launchpad.
Entrar
A forma mais simples de conectar é escanear ou colar uma URL de conector do agente que você deseja controlar:
- No agente, abra o QR code de pareamento — o painel Conectar no app de desktop, ou a aba Dashboard na TUI do CLI (pressione r para atualizar, y para copiar a URL).
- Abra o app Mac, vá para a página Conectar e escaneie o QR ou cole a URL. Pronto.
As sessões sincronizam pelo relay, então você pode iniciar uma sessão no Mac e retomá-la no celular — e vice-versa.
Cliente vs. agente
| Papel | O que é | Onde roda |
|---|---|---|
| Cliente (app Mac ou app iOS) | O que você usa para controlar | Seu Mac ou iPhone |
| Agente (app de desktop ou CLI) | O que está sendo controlado | Seu computador em casa / VPS |
São papéis diferentes. O cliente iOS no Mac não executa o agente — você ainda precisa de um agente (o app de desktop no Mac/Windows, ou o agente CLI) rodando no computador que você quer controlar.
Macs Intel
A App Store não oferece apps iOS em Macs Intel. Para executar um agente em um Mac Intel, use o agente CLI (funciona no macOS 10.15+ amd64) e conecte a partir do seu iPhone.
Limitações
- A janela redimensiona livremente, mas o layout segue os padrões do iPad/iPhone — não é uma interface macOS redesenhada.
- Alguns recursos exclusivos do iOS (hápticos, Live Activities) não estão disponíveis no Mac.
- Notificações push funcionam via APNs apenas no relay oficial. Relays auto-hospedados não entregam notificações.
App de desktop nativo vs. este
Existe um App de Desktop nativo para Mac e Windows — mas ele tem um papel diferente. O app de desktop executa o agente nesta máquina. O cliente iOS no Mac descrito aqui controla um agente rodando em outro lugar. Use o app de desktop para transformar este Mac no computador sendo controlado; use o cliente iOS no Mac para controlar um computador diferente a partir dele.