Pular para o conteúdo
ColliePWA

Uma interface móvel para os seus agentes de terminal.

O ColliePWA se integra onde você já trabalha, no multiplexador de terminal da sua máquina. Agentes de código rodam em painéis divididos e solicitam entrada. O ColliePWA lista instâncias em execução, sinaliza sessões bloqueadas e permite que você responda pelo celular.

  • Backend do multiplexador:
  • Herdr
  • tmux
  • Zellij

O Herdr é o backend principal suportado na versão 1.0. O suporte a tmux e zellij é experimental. Detalhes em Multiplexers

Demonstração interativaCódigo-fonte

Captura estática da interface com sessões simuladas. A interface de demonstração não é interativa.

01/Demonstração

Demonstração interativa.

Este é o cliente ColliePWA de produção. Agentes, terminais e respostas usam dados simulados reproduzidos localmente no seu navegador. Nada é executado em um servidor e nenhum tráfego de rede é enviado.

  1. 01Selecione o agente bloqueado no topo da lista.
  2. 02Inspecione o prompt. Isso espelha a saída bruta do terminal diretamente.
  3. 03Toque em uma resposta para retomar a execução.
  4. 04Selecione Keys para acessar modificadores e navegação: Esc, Tab, setas e Ctrl.
Abrir demonstração em tela cheia

02/Arquitetura principal

Primitivas principais e adições da versão 1.0.

durante a execução

Espelhamento direto do terminal

O ColliePWA transmite a saída bruta do terminal do agente com suporte completo a cores ANSI, evitando transcrições ou resumos com perdas. A visualização móvel corresponde ao terminal do seu desktop byte a byte.

Painel de terminal espelhado durante a execução do agente com cores ANSI. ColliePWA executando desconectado. As interações por toque estão desativadas sem um backend ativo.

quando a entrada for necessária

Respostas de entrada com um único toque

Solicitações interativas de permissão são renderizadas como botões de ação discretos. A entrada é validada contra o estado atual do terminal antes do envio para evitar envios dessincronizados.

Painel bloqueado aguardando confirmação do usuário em uma solicitação de permissão. ColliePWA executando desconectado. As interações por toque estão desativadas sem um backend ativo.

Novidades no 1.0

03Suporte a localização

Traduções de interface para inglês, alemão, espanhol, coreano, japonês e chinês, configuradas em Settings. Apenas a moldura da interface do usuário é traduzida; os fluxos do terminal do agente permanecem com bytes idênticos.

Detalhes em Configure

Interface de seleção de idioma em Settings. ColliePWA executando desconectado. As interações por toque estão desativadas sem um backend ativo.

04Autorização explícita de dispositivos

collie pair gera um token de oito caracteres com TTL de dez minutos e limite de cinco tentativas. O cliente troca isso por um token de autenticação cujo hash é armazenado pela bridge. Revogar um dispositivo descarta sua próxima solicitação.

Detalhes em Security

Tela inicial de pareamento em uma bridge não vinculada. ColliePWA executando desconectado. As interações por toque estão desativadas sem um backend ativo.

05Transcrição de entrada de voz

O recurso aperte-para-falar transcreve diretamente para o compositor de entrada. Suporta APIs compatíveis com OpenAI, instâncias locais de whisper.cpp ou parakeet.cpp, ou credenciais existentes do Codex CLI sem chaves separadas. Requer HTTPS via tailscale serve ou um proxy reverso.

Detalhes em Voice input and Web Push

Configuração de voz roteando destinos de saída de transcrição. ColliePWA executando desconectado. As interações por toque estão desativadas sem um backend ativo.

06Web Push na mudança de estado

O Web Push opcional envia notificações quando um agente bloqueia aguardando entrada ou conclui a tarefa. Selecionar uma notificação abre esse agente. Filtros de transição e períodos de não perturbe abrangem toda a bridge em todos os dispositivos. Requer HTTPS e collie push-keys.

Detalhes em Voice input and Web Push

07Workspaces de git worktree

O Herdr aninha git worktrees diretamente sob o checkout do repositório pai em vez de criar entradas de nível superior. Worktrees são rastreados como workspaces nativos.

Dois worktrees aninhados sob o repositório `collie`; o workspace externo `blog` é renderizado de forma plana. ColliePWA executando desconectado. As interações por toque estão desativadas sem um backend ativo.

08Modo Zen

Uma configuração opcional que adiciona um alternador ao menu do painel para recolher toda a navegação e exibir apenas o terminal. Deixa um único botão flutuante para sair.

Detalhes em Configure

Configuração do alternador do modo Zen nas configurações do painel. ColliePWA executando desconectado. As interações por toque estão desativadas sem um backend ativo.

Topologia de rede

09Gateway de transporte configurável

O ColliePWA vincula-se estritamente a localhost sem ingresso público. O transporte para dispositivos móveis pode usar a configuração automatizada do Tailscale em collie start, malhas WireGuard, túneis ou proxies reversos padrão.

Detalhes em Security

10Coordenação de crew multi-host

Um crew é o ColliePWA em cada máquina. Seu telefone alcança todos eles por meio do lead. Uploads, diários, logs de auditoria, atualizações e failover ocorrem por máquina, também sob tmux e zellij. As máquinas salvas do Herdr permanecem na própria janela do Herdr. O crew é o que seu telefone vê.

Detalhes em Crews

Visualização da topologia de hosts mostrando nós lead, deputy e pares. ColliePWA executando desconectado. As interações por toque estão desativadas sem um backend ativo.

Recursos adicionais

11Supervisão unificada de processos
Agrupa agentes em execução pelo estado de execução, priorizando processos bloqueados no topo da interface.
12Retenção completa de scrollback
O ColliePWA transmite logs completos da sessão do agente, preservando o scrollback histórico além do viewport atual do terminal.
13Multiplexação de várias sessões
Expõe todas as sessões do Herdr configuradas a partir de um único gateway, selecionáveis na barra de navegação superior.

Lista completa no README do ColliePWA

03/Para quem foi feito

Para desenvolvedores que executam agentes em um multiplexador e se afastam da mesa.

O ColliePWA foi feito para um operador com vários agentes de codificação em execução em painéis de terminal em um único host. Ele não substitui o terminal. Ele permite responder a um agente que está esperando a partir de um celular e depois voltar ao que você estava fazendo.

Funciona onde você já trabalha
Ele se conecta ao multiplexador que você já usa, Herdr, tmux ou zellij. Nenhum modelo de sessão novo e nenhum wrapper em torno do agente. O Herdr é o backend suportado na versão 1.0. O tmux e o zellij são experimentais.
Sem loja de aplicativos, sem nuvem, sem conta
Um PWA servido a partir da sua própria máquina através da sua tailnet. Sem listagem em loja, sem conta de fornecedor e sem camada em nuvem. Os únicos serviços externos são aqueles que você ativa: o serviço de push do navegador e um endpoint de transcrição em nuvem se você escolher um em vez de um mecanismo local. Adicione-o à tela inicial e ele roda como um aplicativo.
Construído para o teclado que você não tem
Teclas especiais, setas e modificadores ficam em um teclado virtual. Suas próprias respostas rápidas e comandos de barra levam apenas um toque. O editor de texto é um campo simples, de modo que o ditado do celular funciona diretamente. A entrada de voz integrada fica disponível assim que você executa collie stt setup em uma origem HTTPS.
Notificações quando um agente precisa de entrada
O Web Push opcional avisa quando um agente bloqueia aguardando entrada ou é concluído. Tocar na notificação abre aquele painel. Requer HTTPS e collie push-keys.
Várias máquinas, uma URL
Uma crew coloca cada host atrás de um único endereço, com um failover que você autoriza com antecedência e aciona a partir do navegador. Uma confirmação atualiza toda a crew a partir da mesma tela.
Licença MIT. Venha e contribua.
O código-fonte está no GitHub sob a licença MIT. Relatórios de bugs de configurações com tmux e zellij são bem-vindos, incluindo relatórios de configurações que funcionam.

04/Arquitetura

Modelo de execução local e limites de segurança.

O ColliePWA escreve nas suas sessões de terminal interativas com as permissões do seu usuário atual. Qualquer cliente com acesso de rede à porta pode ler a saída do terminal e executar comandos arbitrários.

Executa no host local do agente
Espelha diretamente as sessões locais do multiplexador. O Herdr é totalmente suportado na 1.0; os backends do tmux e do zellij são experimentais. Funciona sem backends em nuvem, servidores remotos ou contas externas.
Associação exclusiva a loopback
Ele se associa a loopback e nunca a 0.0.0.0. Exatamente uma porta de entrada protegida é publicada: tailscale serve, ou um proxy reverso configurado por você. Nunca funnel.
Autenticação no nível do host
O controle de acesso é gerenciado na camada de rede em vez de logins de aplicativo. Qualquer usuário em um dispositivo autorizado tem acesso completo ao shell.
Limite de acesso ao sistema local
Os unix domain sockets do multiplexador impõem permissões do sistema de arquivos local. A porta TCP do ColliePWA é acessível a outros usuários locais. Imponha o isolamento usando filtros de entrada e COLLIE_TRUSTED_USER.

Código-fonte sob licença MIT. Revise a nota de segurança para detalhes sobre controles de acesso e limites de confiança.

05/Instalação

Instale via script shell ou compile a partir do código-fonte.

O ColliePWA executa ao lado dos seus agentes, na máquina que já os possui. O script baixa uma versão para a sua plataforma e a verifica. A compilação a partir do código-fonte precisa de git e Bun, sendo o caminho para máquinas não cobertas pelas versões lançadas. Ambos terminam com collie no seu PATH, e nenhum deles inicia nada.

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

Um instalador POSIX sh curto. Ele dispensa sudo, não inicia serviços do sistema e isola arquivos em ~/.local/share/collie e ~/.local/bin. Ele busca a versão mais recente, valida o hash sha256 publicado, grava o binário e atualiza o PATH. Requer curl, tar e ferramentas de sha256.

Disponibilizado localmente a partir desta origem. O código-fonte canônico está localizado em scripts/install.sh no repositório. Inspecione o script antes de executar:

$ curl -fsSL https://raw.githubusercontent.com/AltanS/collie/main/scripts/install.sh | less
$ curl -fsSL https://raw.githubusercontent.com/AltanS/collie/main/scripts/install.sh | sh

Execute collie update para buscar, verificar e alternar para versões mais recentes. Versões anteriores permanecem em cache para collie update --rollback. Compilações a partir do código-fonte atualizam as revisões do git diretamente, sem alvos de reversão de versão.

Originado de scripts/install.sh em 2ded11d, 2026-08-31.

Resta uma etapa: inicie-o.

# one step left. It asks which multiplexer to mirror — herdr, tmux or
# zellij — and writes your answer to ~/.config/collie/.env, creating it.
$ collie start

A configuração é opcional e fica em ~/.config/collie/.env, o arquivo que start cria. Defina COLLIE_TRUSTED_USER nele, além da porta ou da porta de entrada se os padrões não atenderem.

Acesse a URL gerada a partir do seu dispositivo móvel pela sua rede local. Adicione à tela inicial para o modo de tela cheia.

Requer entrada privada. O ColliePWA se associa estritamente a interfaces loopback. O Tailscale é configurado por padrão: collie start executa tailscale serve no seu hostname do MagicDNS. Proxies reversos personalizados, redes mesh e túneis SSH estão documentados em DEPLOYMENT.md. Arquitetura exclusiva para um único usuário.

Pré-requisitos, guias de compilação e saída inicial