Edições, plataformas e atualização do Herdr
O Herdr existe em três edições que dividem o nome e a proposta de manter agentes de código vivos em terminais persistentes. O Herdr TUI desenha workspaces e painéis dentro do terminal e tem servidor próprio. O Herdr Core mantém terminais pelo comando hc, e o Herdr Desktop usa esse core numa janela gráfica. As sessões de uma edição não aparecem na outra.
Três edições com servidores separados
As três edições guardam os terminais num processo de servidor que continua rodando quando a interface fecha. A diferença está na forma de chegar a esses terminais e no servidor que cada edição usa:
herdr.No servidor próprio do Herdr TUI, uma sessão por servidor.hc run, lê a saída com hc read e espera estados com hc wait.No servidor do herdr-core da máquina escolhida.hc.Como o Herdr TUI e o herdr-core são servidores diferentes, um painel aberto no Herdr TUI não aparece no Herdr Desktop. Do mesmo jeito, um terminal iniciado com hc run fica fora da barra lateral do Herdr TUI. A escolha da edição acompanha o jeito de acessar os projetos. O Herdr TUI roda inteiro num terminal, inclusive num servidor acessado por SSH (Secure Shell) a partir do celular. O Herdr Desktop precisa de um ambiente gráfico na máquina onde a janela abre. As páginas deste portal explicam principalmente o Herdr TUI. As edições gráficas têm páginas próprias em Herdr Desktop e Herdr Core.
Sistemas atendidos
O Herdr TUI publica binários estáveis para Linux, macOS e Windows. A versão 0.9.5 traz um arquivo por sistema e arquitetura nas releases do GitHub:
herdr-linux-x86_64Linux em processadores Intel e AMD de 64 bits.herdr-linux-aarch64Linux em processadores ARM de 64 bits.herdr-macos-x86_64macOS em Macs com processador Intel.herdr-macos-aarch64macOS em Macs com Apple silicon.herdr-windows-x86_64.zipWindows de 64 bits, com o executável e o runtime ConPTY na mesma pasta.Windows ARM64Roda o arquivo x86_64 pela emulação do Windows, sem binário próprio.
O suporte ao Windows está disponível no canal estável, com limitações conhecidas que a página oficial de suporte ao Windows lista. A pasta extraída do zip precisa ficar inteira, porque o herdr.exe usa o runtime ConPTY que vem ao lado dele. O Herdr Desktop tem outro manifesto de arquivos, com versões para macOS com Apple silicon, Linux x86_64 e ARM64 e Windows x86_64, como registra a página do Herdr Desktop.
Formas de instalação
No Linux e no macOS, o instalador oficial é o script curl -fsSL https://herdr.dev/install.sh | sh, que baixa o binário da sua plataforma e coloca o executável no PATH. No Windows, o equivalente é o script em PowerShell, com uma versão para o Prompt de Comando quando a proteção da máquina recusa o comando sem arquivo. O Herdr também chega pelo Homebrew, pelo mise e pelo Nix, que constrói o binário a partir do código-fonte. A instalação manual usa os arquivos da tabela acima.
A forma de instalação define a ferramenta que atualiza o binário depois. As instalações feitas pelo script oficial aceitam herdr update e os canais de atualização. As instalações pelo Homebrew, pelo mise ou pelo Nix seguem o gerenciador de pacotes, por isso o comando herdr update fica fora delas. O passo a passo com os comandos de cada sistema e a conferência da primeira sessão está no tutorial Instale o Herdr e abra uma sessão.
Canais e atualização
As instalações diretas usam o canal estável por padrão. O comando herdr channel set preview troca para o canal de prévia, que recebe as releases publicadas a partir da branch de desenvolvimento. A documentação registra que esse canal recebe correções mais cedo que o estável e também pode trazer regressões. O comando herdr channel set stable volta ao canal estável. O Homebrew, o mise e o Nix não oferecem o canal de prévia.
Durante a atualização, o binário novo é instalado e os servidores em execução continuam rodando com os processos dos painéis. Você reconecta com o cliente novo, que conversa com o servidor antigo enquanto as versões forem compatíveis. Uma ação nova do lado do servidor só aparece depois que esse servidor é atualizado e reiniciado. Ao terminar, o herdr update lista os servidores que continuam na versão anterior e as máquinas SSH salvas, que rodam o próprio Herdr e precisam de atualização em cada uma.
A opção herdr update --handoff tenta passar os painéis em execução para o servidor novo sem encerrar os processos. A documentação trata essa passagem como experimental, opcional e feita com o melhor esforço nos servidores compatíveis. Ela não se aplica às atualizações pelo Homebrew, pelo mise ou pelo Nix. Quando a passagem vem de um servidor mais antigo, um agente em execução pode aparecer como idle por algum tempo, até a próxima atualização de estado chegar.
Versão do cliente e do servidor
Depois de uma atualização, o cliente e o servidor podem ficar em versões diferentes. O comando herdr status mostra a versão do cliente local e a do servidor em execução. Com ele, você confere se um recurso novo já está disponível na sessão aberta. A falta de um recurso no servidor desativa só a ação correspondente no cliente, que mostra um aviso em vez de desconectar.
As versões citadas neste portal ficam registradas em cada página. As páginas usam o Herdr TUI 0.9.5, release estável publicada em 14/10/2026 e instalada na máquina usada na conferência. O Herdr Core de referência é o 0.1.19. A página Herdr 0.9.5 resume o que mudou nessa versão. O changelog do Herdr acompanha as releases seguintes.