Ir para o conteúdo
Promovaweb

O Herdr em servidores remotos e no celular

O Herdr TUI roda o servidor na máquina onde estão o código e as credenciais. O cliente se liga a ele de onde você estiver. Numa VPS (servidor virtual privado), os agentes continuam trabalhando com o notebook fechado. Você volta aos mesmos painéis por SSH (Secure Shell), pelo herdr --remote ou pela lista de máquinas cadastradas.

O servidor fica onde o trabalho roda

O servidor do Herdr TUI guarda os painéis e os processos, por isso a máquina que roda o servidor é a mesma que roda os agentes, os testes e o servidor de desenvolvimento. Numa VPS, esses processos continuam ativos depois que o notebook fecha ou perde a conexão, porque nenhum deles depende do cliente que estava aberto. Ao voltar, você reconecta o cliente e encontra cada agente no ponto onde ele estiver, inclusive os que pararam numa aprovação à espera de resposta.

A conexão entre as duas pontas é o SSH comum. A autenticação continua com o OpenSSH e com as chaves que você já usa. O Herdr não guarda senhas nem chaves privadas. A documentação 0.9.5 atende clientes Linux, macOS e Windows ligados a servidores Linux ou macOS em x86_64 e aarch64, ou a servidores Windows em x86_64.

Três caminhos até o servidor

O Herdr oferece três formas de chegar a um servidor remoto. Elas diferem no lugar onde a interface roda e na quantidade de máquinas que aparecem numa mesma janela:

ComandoOnde a interface rodaPara que serve
ssh voce@servidor e depois herdrNo servidor. O terminal local só mostra a sessão SSH.Uso no estilo do tmux, inclusive a partir de um cliente SSH no celular ou no tablet.
herdr --remote workboxNa sua máquina, com o seu tema e os seus atalhos, ligada a uma sessão do servidor.A sessão remota com cara de local, com a colagem de imagens da sua área de transferência.
herdr machine add workboxNa sua máquina, com a máquina Local e as máquinas cadastradas na mesma barra lateral.Acompanhar agentes de várias máquinas numa janela só, com reconexão independente.

No primeiro caminho, o Herdr inteiro roda no servidor e funciona como um multiplexador de terminal comum. Você desconecta com ctrl+b q, fecha o SSH e, na volta, entra por SSH de novo e roda herdr. Como o cliente também está no servidor, ele não alcança a área de transferência do seu computador além da colagem de texto que o terminal oferece.

No segundo caminho, o cliente roda na sua máquina e recebe pelo SSH o conteúdo dos terminais e o estado da sessão. Por isso o cliente consegue levar recursos locais ao servidor, como colar uma imagem copiada: o Herdr grava a imagem num arquivo temporário remoto e cola o caminho no painel. O herdr --remote usa os seus atalhos locais por padrão. A opção --remote-keybindings server troca para os atalhos configurados no servidor.

Máquinas cadastradas na barra lateral

O comando herdr machine add <host> prepara o servidor remoto e grava um perfil de conexão. A preparação procura as sessões em execução no host e, num terminal interativo, oferece a escolha quando existe mais de uma. Quando o host não tem o Herdr ou tem uma versão incompatível, a preparação solicita confirmação antes de instalar ou de substituir o servidor. A resposta padrão é não, porque substituir o servidor encerra os processos dos painéis.

Com as máquinas cadastradas, a barra lateral mostra a Local e cada máquina com seus workspaces. A máquina selecionada recebe o que você digita e mostra os terminais. As outras continuam enviando o estado dos agentes e os avisos, sem transmitir a tela dos painéis. A lista de agentes reúne as máquinas conectadas, o que mostra numa mesma lista qual agente, em qual servidor, aguarda resposta.

Quando a conexão cai, o último estado conhecido da máquina fica visível e esmaecido, como informação guardada e não ao vivo. O Herdr tenta reconectar automaticamente depois de uma queda de rede, de uma suspensão ou de uma falha do SSH, com intervalos que crescem até dois minutos. Uma falha de autenticação aparece como ! auth na linha da máquina. O comando herdr machine reconnect faz a autenticação no seu terminal.

Celular e tablet

O Herdr não tem aplicativo móvel nem painel web. A documentação descreve o uso no celular pelo primeiro caminho: um cliente SSH qualquer conecta ao servidor onde os agentes rodam e abre a mesma sessão persistente do Herdr. A interface se adapta a telas estreitas, com um menu de troca próprio, o que permite conferir os agentes, trocar de workspace e ler os painéis sem sair do SSH. A página Trabalhe de Qualquer Lugar mostra esse uso com o Termius.

Nesse caminho, o celular só mostra o terminal remoto. A capacidade necessária fica no servidor, que precisa aguentar os agentes, os testes e as compilações que rodam nos painéis. A rede também precisa estar disponível para você acompanhar e responder, mesmo que os processos continuem rodando enquanto o celular fica sem sinal.

Chaves, Git e comandos em outra máquina

A autenticação por chave com senha precisa da chave carregada no agente SSH, com ssh-add, quando o Herdr abre conexões em segundo plano, porque essas conexões não mostram a solicitação de senha. Para usar o Git com autenticação SSH ou assinar commits dentro dos painéis remotos, você liga ForwardAgent yes para o host confiável no seu arquivo de configuração do SSH. O Herdr deixa esse encaminhamento desligado até você configurar.

Os identificadores de workspace, aba e painel valem dentro de um servidor. Duas máquinas podem ter um w1:p1 cada uma ou um agente chamado reviewer em cada servidor. Selecionar uma máquina na interface não muda o destino dos comandos que rodam num painel. Para controlar uma máquina cadastrada por script, você usa o prefixo herdr --machine <rótulo> em todos os comandos, como mostra a página Automação e plugins.

StayCloud

Uma VPS para desenvolver com agentes

Servidor da StayCloud em São Paulo, com acesso root e disco NVMe, para deixar seus agentes de IA rodando o dia todo.

Montar minha VPS

Link de parceiro da Promovaweb.