Instale em cinco minutos

Este guia configura o Collie no seu celular. Instale três ferramentas no computador, inicie o Collie e pareie seu celular.

Ele usa a configuração recomendada: Tailscale como porta de entrada, Herdr como multiplexador e o script de instalação. Para outras configurações, consulte Instalação.

Nota. O Collie concede acesso remoto via shell à sua máquina por design. Leia Segurança antes de instalá-lo.

O que você precisa

• —
  Um computador com Linux ou macOS (o host). Um Mac precisa de Apple Silicon e macOS 13 ou mais recente.
• —
  Um iPhone ou um celular Android.
• —
  Uma conta Tailscale.

1. Instale o Tailscale

O Tailscale conecta o host e o seu celular em uma única rede privada, a sua tailnet. O Collie fica acessível apenas nessa rede.

Em um host Linux:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up --operator=$USER

--operator=$USER permite que seu usuário execute tailscale serve, que o Collie precisa na etapa 4.

Em um Mac, instale o Tailscale a partir de tailscale.com/download e faça login. Instale o comando tailscale nas configurações do aplicativo. O Collie o chama.

Em seguida, configure a tailnet e o celular:

1. 01
   Abra o console de administração e selecione Enable HTTPS. O Collie exige isso.
2. 02
   Instale o aplicativo Tailscale no celular. Faça login com a mesma conta.

2. Instale o Herdr

O Herdr mantém os painéis do terminal e os agentes de código em execução no host quando você desconecta. O Collie exibe esses painéis no celular.

curl -fsSL https://herdr.dev/install.sh | sh    # or: brew install herdr
herdr

O Herdr abre um painel. Inicie seu agente lá, por exemplo claude. Deixe o Herdr em execução.

3. Instale o Collie

Abra um segundo terminal no host e execute o script de instalação:

curl -fsSL https://colliepwa.dev/install.sh | sh

O script salva o binário do collie em ~/.local/bin. Ele não usa sudo. Se o seu shell não encontrar collie, adicione ~/.local/bin ao seu PATH. Standalone aborda os detalhes.

4. Inicie o Collie

COLLIE_MUX=herdr collie start

start executa o Collie em segundo plano e o expõe na sua tailnet com tailscale serve. Ele salva herdr como o multiplexador. Execuções futuras precisam apenas de collie start. Quando estiver pronto, ele imprime O Collie está em execução e exibe sua URL na linha tailnet, por exemplo https://myhost.tail1234.ts.net.

Em um host Linux remoto acessado por SSH, mantenha o Collie em execução após o logout:

loginctl enable-linger $USER

5. Coloque o Collie no celular e faça o pareamento

collie qr

1. 01
   Escaneie o código QR com a câmera do celular para abrir o Collie no navegador.
2. 02
   Adicione o Collie à tela de início para abrir em tela cheia como um app. - iPhone: no Safari, toque em Compartilhar, toque em Adicionar à Tela de Início e toque em Adicionar. - Android: no Chrome, abra Configurações do Collie e toque em Instalação no card superior.
3. 03
   Abra o Collie a partir do novo ícone.
4. 04
   Execute collie pair no host para exibir um código de 8 caracteres, válido por 10 minutos.
5. 05
   No Collie, abra Configurações → Sistema → Dispositivos emparelhados.
6. 06
   Digite o código e um nome, por exemplo my phone, e toque em Emparelhar este dispositivo.

Faça o emparelhamento dentro do app da tela de início, não na aba do navegador. No iPhone, o app da tela de início mantém seu próprio armazenamento, separado do Safari. Um emparelhamento feito no Safari não é transferido.

Assim que um dispositivo for emparelhado, somente dispositivos emparelhados poderão digitar nos seus painéis. Até lá, qualquer dispositivo na sua tailnet poderá digitar. Faça o emparelhamento logo após start. Em uma tailnet compartilhada com outras pessoas, defina também COLLIE_TRUSTED_USER (Configuração).

O painel lista os seus painéis do Herdr. Os painéis que aguardam entrada aparecem primeiro. Toque em um painel para ver a saída e responder.

Próximos passos

• —
  Claude Code no tmux ou Herdr, no seu celular mostra um dia inteiro de uso com o Claude Code.
• —
  Web Push adiciona notificações quando um agente precisa de entrada.
• —
  Configuração documenta como restringir o Collie ao seu usuário da tailnet com COLLIE_TRUSTED_USER.
• —
  Solução de problemas cobre erros comuns.