#App iOS

O app do cmux para iOS é um complemento para o seu Mac. Pareie seu iPhone ou iPad com um Mac executando o cmux e conecte-se aos seus terminais pelo celular, com encaminhamento opcional das notificações do terminal.

O app iOS está em beta. Ele é distribuído no TestFlight como cmux BETA.

#Como obter acesso

O app é distribuído pelo TestFlight. O acesso antecipado está incluído na cmux Founders Edition, junto com outros recursos antecipados.

#Pré-requisitos

Antes de começar, você precisa de:

  • Um Mac executando o cmux e com login feito.
  • Um iPhone ou iPad com o app cmux BETA instalado pelo TestFlight.
  • Um caminho de rede do seu celular até o seu Mac (consulte Rede própria abaixo).

#Rede própria

O cmux não fornece rede pronta para uso. O fluxo do terminal vai diretamente entre o seu celular e o seu Mac, então o celular precisa conseguir alcançar o Mac na rede. A forma mais simples é uma rede de sobreposição privada.

#Tailscale (recomendado)

Instale o Tailscale no seu Mac e no seu celular e faça login na mesma tailnet. Seu celular passa a alcançar o Mac pelo endereço de tailnet de qualquer lugar, sem encaminhamento de portas.

#WireGuard

Se você já usa o WireGuard, coloque seu Mac e seu celular na mesma rede e use o endereço WireGuard do Mac.

Qualquer que seja a escolha, a conexão é sua. O cmux não faz proxy nem retransmite o tráfego do terminal entre os seus dispositivos.

#Parear e conectar

  1. No Mac, abra a janela Mobile Connect no cmux.
  2. No celular, abra o app cmux BETA e confirme o pareamento mostrado em Mobile Connect.
  3. Depois de pareados, seus workspaces e terminais aparecem no celular pela sua rede.

O pareamento é por dispositivo. Um novo dispositivo, ou um app reinstalado, pareia de novo.

#Notificações

Você pode optar por encaminhar as notificações do terminal para o seu celular, de modo que um painel que precisa de atenção envie um aviso ao seu dispositivo. Quando o encaminhamento está ativado, o texto da notificação (título e corpo, extraídos da saída do terminal) é enviado pelos servidores do cmux ao serviço de push da Apple para entrega. Ative Hide content nas configurações de notificação para enviar uma mensagem genérica e manter o texto do terminal nos seus dispositivos. Consulte notificações para saber como o cmux as gera.

#Quais dados são armazenados

O cmux foi feito para que o seu terminal fique entre os seus dispositivos. Nos servidores do cmux armazenamos apenas o necessário para fazer seu login e conectar seus dispositivos:

  • Sua conta do login (e-mail), para identificá-lo entre os dispositivos.
  • Um token de push do seu dispositivo, para entregar as notificações de terminal encaminhadas.
  • Metadados de pareamento e do dispositivo, para conectar seu celular ao seu Mac.
Sua sessão interativa de terminal, seu conteúdo e suas teclas digitadas fluem diretamente entre o seu celular e o seu Mac pela sua própria rede, e não são retransmitidos por nem armazenados nos servidores do cmux. A única exceção é o texto de notificação encaminhado, que transita pelo cmux e pelo serviço de push da Apple para chegar ao seu celular, a menos que você ative Hide content (consulte Notificações acima).

#Empresarial e auto-hospedado

Para uma implantação auto-hospedada ou isolada da internet, entre em contato com founders@manaflow.com.