Sessões, desconexão e restauração no Herdr
No Herdr TUI, o servidor guarda os painéis e os processos de uma sessão enquanto o cliente só desenha a interface. Desconectar o cliente mantém tudo rodando. Reiniciar o servidor encerra os processos e devolve o formato da sessão a partir do arquivo session.json, com caminhos próprios para o histórico da tela e para a conversa dos agentes.
Desconectar mantém os processos vivos
O atalho ctrl+b q desconecta o cliente e fecha a interface. O servidor da sessão continua rodando na máquina com os shells, os agentes, os testes e os servidores de desenvolvimento de cada painel. Quando você roda herdr de novo, o cliente se liga ao mesmo servidor e mostra os painéis do jeito que estavam, com a saída que apareceu durante a ausência.
A documentação chama esse caminho de persistência ao vivo e o descreve como o mais forte, porque os processos originais continuam os mesmos do começo ao fim. No Linux e no macOS, o servidor também ignora o sinal SIGHUP, de modo que fechar a janela do terminal que iniciou o Herdr não derruba os painéis. Para encerrar a sessão de propósito, você usa herdr server stop ou envia SIGTERM ao processo do servidor.
O que sobrevive a cada situação
Cada situação aciona um caminho de recuperação diferente. A tabela da documentação 0.9.5 compara o que volta em cada caso:
session.json.A tela volta só com o histórico de tela ligado. A conversa volta só com a retomada nativa do agente.A diferença entre as linhas está no processo. Enquanto o processo original existe, tudo continua. Depois que ele termina, cada parte do ambiente volta por um mecanismo separado, com requisitos próprios.
O formato da sessão depois de um reinício
Quando o servidor para e inicia de novo, os processos dos painéis já terminaram. O Herdr restaura o formato salvo da sessão: workspaces, abas, painéis, diretório de trabalho de cada painel, layout e foco. Os painéis sem um caminho de recuperação mais forte voltam como shells novos nos diretórios salvos, sem os servidores, os testes ou os comandos que rodavam antes.
Quando um diretório salvo deixou de existir ou o shell não consegue iniciar, o painel continua no layout com uma mensagem de erro, em vez de sumir ou abrir na pasta pessoal. O diretório e a referência da sessão do agente ficam guardados. Você corrige o diretório ou a configuração do shell e reinicia o servidor para tentar de novo, ou fecha o painel para tirá-lo do layout.
O Herdr também guarda até 48 cópias do layout na pasta session-snapshots/, ao lado do session.json, com no máximo uma cópia nova a cada 15 minutos. A restauração dessas cópias é manual. Para recuperar um layout antigo, você para o servidor, guarda o session.json atual e grava por cima dele o arquivo escolhido em session-snapshots/. As cópias contêm layout e referências de sessão dos agentes, sem processos nem histórico de tela. A documentação recomenda tratá-las como informação privada da sessão.
Histórico de tela e retomada dos agentes
O histórico de tela devolve o conteúdo recente de cada terminal depois de um reinício completo do servidor, sem devolver o processo. Ele vem desligado por padrão porque a saída dos painéis pode conter tokens, segredos, prompts e resultados de comandos. A chave pane_history = true, na seção [experimental] da configuração, liga o recurso, que grava o arquivo session-history.json ao lado do session.json. O histórico só é reaplicado quando coincide com o layout salvo exatamente, por isso ele é ignorado depois de uma recuperação manual de layout.
A retomada nativa dos agentes devolve outra parte do ambiente: a conversa. Alguns agentes reabrem a própria conversa a partir de um identificador. As integrações oficiais reportam esse identificador ao Herdr. Depois de um reinício, quando um cliente se liga ao servidor e informa o tamanho do terminal, o Herdr reinicia os painéis elegíveis com o comando de retomada de cada ferramenta, como claude --resume <id> ou codex resume <id>. A chave resume_agents_on_restore, na seção [session], vem ligada por padrão. As versões mínimas de cada integração estão na página Agentes de código.
- Formato da sessãoWorkspaces, abas, painéis, diretórios e foco, lidos do session.json.
- Histórico de telaConteúdo recente dos terminais, só com pane_history ligado.
- Retomada do agenteA conversa reaberta pelo comando de retomada, com a integração oficial.
Quando a retomada nativa vale para um painel, o Herdr reabre a conversa do agente no lugar de reaplicar o histórico de tela daquele painel. Referências de sessão ausentes, inválidas ou antigas fazem o painel voltar como um shell comum no diretório salvo.
Desligamento da máquina e sessões nomeadas
Nos sistemas Linux com systemd-logind, o Herdr recebe o aviso de desligamento da máquina e solicita um atraso curto para gravar a sessão e parar. O sistema operacional limita esse atraso. A proteção não cobre desligamento forçado, queda de energia ou processos encerrados antes do aviso chegar. As alterações mais recentes do layout podem não estar nas cópias de recuperação.
As sessões nomeadas criam servidores independentes, cada um com painéis, sockets e estado próprios. Você abre uma com herdr session attach <nome>, lista as existentes com herdr session list, para uma com herdr session stop <nome> e apaga uma sessão parada com herdr session delete <nome>. Parar uma sessão nomeada encerra os processos dos painéis dela, do mesmo jeito que herdr server stop faz com a sessão padrão. O procedimento de saída e retorno, com a conferência do resultado, está no tutorial Desconecte e volte à sessão.