Herdr TUI, Desktop e herdr-core: cada terminal no lugar
VPS Agêntica
O mesmo ambiente do SetupVibe, agora numa VPS
Os atalhos, o shell e as CLIs de IA que você já usa no computador rodam numa VPS da StayCloud com servidor no Brasil.
Link de parceiro da Promovaweb.
Black Friday até 30/11
30%off
nos 2 primeiros meses do plano mensal da VPS
- Backup diário grátis para sempre
- Servidores em São Paulo no datacenter da Ascenty
- Datacenter Tier III manutenção sem parada
- Acesso root com disco SSD NVMe
- Réplica do backup em Ashburn, nos EUA
O Herdr tem dois produtos e um core, cada um com o seu comando. Misturar os dois cria a aba no lugar errado, então o Herdrfy separa as superfícies, escolhe o comando certo e continua trabalhando quando a janela do Desktop está num computador e os terminais em outro.
Nesta página
Dois produtos, dois comandos
O Herdr TUI roda dentro de um terminal e organiza workspaces, abas e painéis com o comando herdr. O Herdr Desktop abre uma janela própria, com espaços, abas e painéis, enquanto os terminais vivem no herdr-core. Nessa superfície, o comando dos terminais e dos agentes é hc e a janela responde a herdr-app.
A confusão começa quando um comando da superfície errada funciona, porque num terminal do herdr-core o comando herdr pode chegar ao servidor do TUI e criar a aba lá. O comando não falha, a aba não aparece na janela que você está olhando e o trabalho segue num lugar que ninguém vê.
O Herdrfy impede a mistura pela árvore de processos. Se o ancestral mais próximo é herdr-core, a superfície é o Desktop e o comando é hc. Se o ancestral é herdr, a superfície é o TUI e o comando é herdr. Essa escolha vale mesmo quando as variáveis de ambiente dizem outra coisa.
Abra o guia de superfícies para ver a diferença por dentro. O guia mostra o comando de cada produto e o que ele controla.
Por que o ambiente engana
Um terminal pode carregar sinais das duas superfícies ao mesmo tempo. Isso acontece quando o herdr-core foi iniciado dentro de um painel do Herdr TUI. O core guarda aquele ambiente e repassa as variáveis a todo terminal novo, mesmo depois de atualizar.
O resultado prático é uma aba aberta no Desktop que aparece no TUI, porque o comando do TUI funciona com o servidor no ar e cria a aba no produto errado. O contrário também acontece, quando um painel do TUI aberto dentro de um terminal do core herda o endereço do outro produto e as variáveis antigas parecem um endereço válido.
O localizador do Herdrfy lê a árvore de processos e mostra os dois lados da detecção. Quando encontra variáveis herdadas, ele avisa e indica a limpeza para você rodar num terminal fora do Herdr, porque a skill não reinicia o core sozinha.
Veja o procedimento de limpeza no guia de problemas comuns. A página explica a origem da herança e o comando que você roda fora do Herdr.
A janela num computador, os terminais em outro
É comum a janela do Herdr Desktop rodar no notebook enquanto os terminais rodam num servidor. Nesse arranjo o herdr-app não existe no servidor. O Herdrfy continua funcionando, porque abre painéis, abas e espaços pelos rótulos do hc e a janela mostra o resultado.
Só o nome da aba e a posição exata do painel dependem da janela, então o agente informa o que conseguiu abrir e o endereço de cada terminal. Você acompanha pelo Desktop mesmo com o trabalho rodando longe, o que resolve o caso de uma tarefa demorada.
Esse arranjo é útil para comandos longos, arquivos e terminais em outras máquinas, porque o agente usa o herdr-core para o trabalho pesado e o seu notebook fica livre para o resto. A janela continua sendo o lugar de acompanhar, enquanto o core faz o trabalho.
Consulte a referência do herdr-core para ver o uso num servidor. O guia mostra como os terminais aparecem na janela e o que fica fora dela.
Quando não existe aba para repetir
Um terminal do core pode ser criado fora da janela, pelo aplicativo móvel, por um comando no servidor ou como auxiliar de outro agente. Ele não pertence a uma aba, mesmo quando aparece com nome de espaço e aba. Nesse caso o que a skill abrir fica como auxiliar sem painel.
O agente avisa você e informa o endereço, então você escolhe o próximo passo. Para ver o auxiliar numa aba, basta indicar uma aba nova. O relato diz se o terminal ficou em painel ou como auxiliar.
Essa escolha evita prometer um painel que o ambiente não tem. O relato final registra o que foi aberto e você decide o que fazer com o endereço. O guia de painéis e abas mostra como abrir uma aba para o auxiliar.
- Onde roda
dentro de um terminal - Estrutura
workspaces, abas e painéis - Comando
herdr
- Onde roda
janela própria - Estrutura
espaços, abas e painéis - Comando
hc e herdr-app
O que você escolhe
Você não precisa escolher uma superfície fixa, porque pode trabalhar no TUI num projeto de terminal e abrir o Desktop quando quiser a janela. A skill detecta a superfície e usa o comando certo em cada sessão, sem exigir que você decore qual comando pertence a qual produto.
Quando você informa a superfície, a sua frase vence a detecção. Se a detecção contrariar a sua informação, o agente avisa e mostra a diferença. Ele guarda a resposta pelo resto da sessão em vez de perguntar a cada comando.
O ponto de partida é instalar o Herdr que você pretende usar. A documentação de instalação mostra os instaladores por sistema e o que cada produto traz.
Comece pela superfície que você usa
O guia de superfícies mostra a instalação de cada produto, os comandos do TUI e do Desktop e o uso do core num servidor. Leia a parte da sua superfície antes do primeiro painel, porque o comando certo economiza a primeira tentativa.
Abra o guia de superfícies e siga para a instalação do Herdrfy quando quiser o método completo. A instalação deixa a skill pronta para o primeiro painel na superfície que você escolheu.