Repository navigation
Releases
v0.5.0
Esta versão muda o texto do bloco de instruções. Depois de atualizar a skill,
rode node ~/.agents/skills/herdrfy/scripts/instructions.mjs em cada projeto
com o bloco (e com --global, se gravou os arquivos globais).
Novidades
- O localizador responde
advice: onde abrir o próximo terminal quando a pessoa não disse. No TUI, divide o painel enquanto cada metade fica com 80 colunas ou mais (right) ou 20 linhas ou mais (down) e a aba tem menos de 4 painéis; abaixo disso, aba nova. No Desktop, painel enquanto a aba mostra menos de 3 terminais, aba nova a partir daí, e auxiliar quando o terminal não tem rótulos de aba. A saída em texto ganha a linhaNext:. Conferido numa sessão real do TUI: o Herdr divide em metades exatas (120 colunas viram 60 e 60). - Preferência da pessoa em
~/.config/herdrfy/config.json({"open":"auto" | "pane" | "tab"}, ouHERDRFY_CONFIG), devolvida empreferencee aplicada noadvice. Arquivo inválido viraautocom aviso. - O localizador identifica o agente que o roda em
agent: o agente conhecido mais próximo na árvore de processos (Claude Code, Codex, OpenCode, Gemini, Copilot, Kimi, Hermes, Goose, oh-my-pi, Cursor), inclusive os iniciados por Node ou Bun, depois o programa que o Herdr informa e, por fim,CLAUDECODE=1.agent.permissionsdiz se a linha de comando dele leva a flag que dispensa aprovações. A saída em texto ganha a linhaAgent:. - No TUI, a resposta traz
pane.size(largura e altura do painel),tab.paneseneighbors(os outros painéis da aba, com agente e estado). - Herdr ausente:
installeddiz quais binários estão no PATH. Sem nenhum, ou sem o comando da superfície detectada (missing: "hc"oumissing: "herdr"), a resposta trazinstallcom os comandos oficiais para Linux, macOS ou Windows e o texto mostraNot installedeInstall (ask the person first):. Antes, um terminal do core semhcno PATH terminava comCould not query Herdre código 1. doctor.mjs: a pendência de Herdr ausente mostra os instaladores do sistema da pessoa, com PowerShell no Windows e Homebrew no macOS.
Documentação
SKILL.md: a descrição cobre os pedidos que acionam a skill (citar Herdr, dividir a tela, chamar ou delegar a outro agente num ambiente com Herdr, comando demorado em terminal separado, instalar o Herdr). A regra 4 vira "a pessoa decide, depois oadvice", o passo 1 trata o Herdr ausente e o passo 3 abre onde oadviceaponta.- Bloco de instruções: o item 3 vira "Onde abrir", com o
advice, e o item 1 manda oferecer a instalação quando o localizador responderNot installed. references/superficies.md: campos comuns (installed,install,agent,preference,advice), a tabela do cálculo doadvicee os campos novos do TUI.references/configuracao.md: instaladores do Windows e do Homebrew e a seção "Preferência de painel ou aba".references/tui.mdereferences/desktop.md: painel pela direção doadvicee aba nova a pedido ou peloadvice.- Guia e README: aba cheia, preferência fixa, Herdr não instalado e exemplos de saída com
Agent:eNext:.
v0.4.0
Revisão contra os changelogs do Herdr TUI 0.9.5, do herdr-core 0.1.21 e do
Herdr Desktop (herdr-app) 0.1.16. O bloco de instruções não mudou: basta
atualizar a skill.
Novidades
- O localizador lê
TERM_PROGRAMquando a árvore de processos não decide, como no macOS, que não tem/proc.TERM_PROGRAM=herdr, gravado pelo TUI 0.9.2 e mais novos em cada painel, dá TUI antes deHC_TERMINAL_ID; o herdr-core troca esse valor pela identidade dele nos seus terminais. Antes, um painel do TUI aberto dentro de um terminal do core era lido como Desktop nesse caso. Conferido numa sessão real do TUI com a tabela de processos desligada. detection.termProgramtraz o valor deTERM_PROGRAMna resposta em JSON.- Num terminal do core com variáveis herdadas do TUI, a saída em texto ganha uma linha
Fix:que sugerehc server restart --fresh(herdr-core 0.1.20), rodado pela pessoa num terminal fora do Herdr. O core guarda o ambiente com que subiu desde a 0.1.19, e era essa a origem das variáveis herdadas.
Documentação
SKILL.md: a regra 1 citaTERM_PROGRAM, a regra 3 manda mostrar a linhaFix:à pessoa sem rodar o comando por ela, e a regra 12 pede--focus falseemherdr-app do tab.newespace.new.references/superficies.md: nova ordem de detecção, a causa da herança e ohc server restart --fresh,termProgramnos exemplos eidentityconferida nohc0.1.21.references/herdr-core.md, conferido nohc0.1.21:hc attach --observe,hc waitcomexitquando um agente trava, o rascunho da pessoa que segurahc sende notas, máquinas emneeds_logine! stops at logout(com ologinctl enable-lingerque a pessoa roda), o ambiente preservado do core e ohc updateque reinicia um core antigo.references/configuracao.md: chaverestore_screendo herdr-core e reinstalação da integração do Codex depois do TUI 0.9.5, que deixou de gravar ganchos de turno.references/desktop.mdereferences/agentes.md:--focus falseem aba e espaço novos (herdr-app 0.1.16) e o nome que a janela dá a uma aba sem nome.references/tui.md:herdr machine statuse a recusa de comando longo empane runeagent startno macOS.references/agentes.md: Goose, oh-my-pi e o agente do Cursor, reconhecidos pelo Desktop 0.1.16, com a orientação de ler o--helpantes.- Guia:
02-superficies.mde07-problemas-comuns.mdexplicam a origem da herança e ohc server restart --fresh.
Herdrfy 0.3.2
Documentação
- O guia de
docs/user/passou a ser publicado em https://promovaweb.com/docs/herdrfy/. O botão Documentação do README e a seção Documentação apontam para essa página; a página da skill na Central de Skills continua citada. CONTRIBUTING.md: a seção de documentação registra onde o guia é publicado.- Copy do guia de
docs/user/revisada sob o contrato editorial da Promovaweb.
v0.3.1
Documentação
- Nova identidade visual: ícone, logotipo e kit de marca em
brand/. O símbolo mostra painéis em grade, quatro painéis do Herdr com o agente em foco destacado em magenta e o cursor de terminal ativo. brand/traz o logo em SVG e PNG para fundo claro e escuro, favicons de 16 a 512 px, paleta com petróleo e turquesa da Promovaweb e acento magenta próprio, tokens,global.css, tema Tailwind, fontes, relatório de contraste, manifesto com hashes e guia visual.README.md: o cabeçalho abre com o logo do Herdrfy, que troca de versão conforme o tema, e traz a linha "Um projeto da Promovaweb".CONTRIBUTING.md: a tabela de estrutura e a de documentação citambrand/.
v0.3.0
Licença
- A partir desta versão, o projeto é distribuído sob a GNU AGPL 3.0; versões anteriores continuam sob a licença com que foram publicadas.
LICENSEtraz o texto oficial e integral da GNU Affero General Public License 3.0, no lugar da MIT.package.jsondeclaraAGPL-3.0-onlyno campolicense.README.md: a seção Licença aponta para a AGPL 3.0 e avisa que a licença não concede o uso do nome e do logo do Herdrfy nem da marca Promovaweb (AGPL 3.0, seção 7, item e).CONTRIBUTING.md: as contribuições entram sob a mesma licença do projeto.
v0.2.2
Documentação
README.mdreorganizado para quem usa a skill: cabeçalho com o logo da Promovaweb, badges, banner do Discord e links para a documentação em https://promovaweb.com/skills/herdrfy/, para os planos e para o changelog. Ganha as seções Saída para scripts, Feito com (Herdr, herdr-core, Herdr Desktop, Node.js e Skills CLI, com os repositórios), Comunidade e suporte e Promovaweb.CONTRIBUTING.mdconcentra o que é de quem contribui: ambiente, organização do código, fluxo de trabalho, regras, validação, commits e releases. A estrutura de pastas e os comandos de desenvolvimento saem do README..markdownlint.jsonlibera os elementos HTML do cabeçalho desliga a regra do primeiro heading e aceita títulos repetidos em versões diferentes do changelog.
v0.2.1
Esta versão muda o texto do bloco de instruções. Depois de atualizar a skill,
rode node ~/.agents/skills/herdrfy/scripts/instructions.mjs em cada projeto
com o bloco (e com --global, se gravou os arquivos globais), para receber o
aviso sobre terminal do herdr-core.
Correções
-
O localizador decide a superfície pela árvore de processos, do ancestral mais próximo para cima: processo
herdr-coredá Desktop, processoherdrdá TUI. As variáveis de ambiente só decidem quando a árvore não tem nenhuma das duas. Um terminal do core que herdouHERDR_ENV=1eHERDR_PANE_IDde um TUI anterior deixava de ser lido como Desktop quando o ambiente vinha primeiro, e a aba pedida abria no TUI. -
A resposta do localizador traz
detectioncomprocess,enveinheritedEnvnas duas superfícies e fora do Herdr. A saída em texto abre com uma linhaWarning:quando as variáveis da outra superfície estão herdadas, dizendo qual comando chega onde. -
inheritedEnvincluiHERDR_SOCKET_PATHeHC_TERMINAL_SOCKET, as variáveis que levam os comandosherdrehcaos seus servidores, e é medido contra a superfície da árvore de processos, não contra a pedida em--surface. -
--surfaceque contraria a árvore de processos mantém a superfície pedida, marcamismatch: truee avisa no texto que os comandos dessa superfície não chegam onde o agente roda. -
Na busca do TUI, quando a árvore de processos indica um terminal do core, o painel vindo de
HERDR_PANE_IDnão é aceito: a resposta éfound: false, porque esse painel pertence a um TUI que não hospeda este processo. -
Conferido em sessão real do TUI aberta dentro de um terminal do core: o painel herdou
HC_TERMINAL_ID, e o localizador respondeu TUI e achou o painel pelo processo. A 0.2.0 respondia Desktop nesse caso.
Documentação
SKILL.md, regras 1 a 4: o localizador decide pela árvore de processos, num terminal do coreherdrnão serve mesmo comHERDR_ENV=1, e a conferência dedetectionemismatchvem antes de criar aba, painel ou espaço.references/superficies.md: ordem de detecção nova, o objetodetection, o campomismatche os exemplos de JSON com os campos novos.assets/instrucoes-bloco.md: o item da superfície avisa que, num terminal do herdr-core,herdrchega ao TUI e não à janela.- Guia:
docs/user/02-superficies.mdexplica por que a informação da pessoa importa quando as variáveis das duas superfícies convivem no mesmo terminal, edocs/user/07-problemas-comuns.mdganha a seção "Pedi uma aba no Desktop e ela abriu no TUI", com a causa e o que o agente faz agora.
Build
- Testes do localizador com um
/procfalso montado em pasta temporária: terminal do core com variáveis herdadas, painel do TUI comHC_TERMINAL_IDherdado,--surface tuidentro de um terminal do core e árvore semherdrnemherdr-core. O localizador aceitaHERDRFY_PROC_ROOTeHERDRFY_PIDpara isso, e os testes que dependem do ambiente usam uma tabela de processos vazia. A suíte passa de 18 para 22 testes.
v0.2.0
Esta versão troca nomes de scripts, opções, chaves do JSON e marcadores.
Quem já instalou precisa, depois de atualizar a skill, rodar
node ~/.agents/skills/herdrfy/scripts/instructions.mjs em cada projeto com
o bloco de instruções (e com --global, se gravou os arquivos globais), para
o bloco apontar para o localizador novo.
Funcionalidades
- Scripts em inglês, do nome do arquivo às mensagens:
onde.mjsvirawhere.mjs,diagnostico.mjsviradoctor.mjseinstrucoes.mjsvirainstructions.mjs. As opções passam a ser--surface,--project,--filee--remove, e as chaves do JSON seguem o mesmo idioma (surface,found,terminal.space,terminal.tab,neighbors,pending,files,state,conflicts). Skill, referências, guia e README continuam em português. - Os marcadores do bloco de instruções passam a ser
<!-- herdrfy:start -->e<!-- herdrfy:end -->. Um bloco gravado comherdrfy:inicioeherdrfy:fimé reconhecido, aparece comooutdatedno--checke é regravado com os marcadores novos, sem duplicar. - O localizador informa
terminal.placementno Desktop:tab(rótulosherdr.spaceeherdr.tabpresentes),unlabeled(só o rótulowhere) ounone. Informa tambémterminal.identity, copiado dohc get. - Regra nova na skill para terminal sem aba: o que o agente abre fica como auxiliar sem rótulos, com aviso à pessoa, sem copiar rótulos de outro terminal nem montar IDs a partir do texto de
where. - Referência nova
references/herdr-core.md, com os comandos dohc: terminais, lançamento, templates, esperas e seus retornos, mensagens entre agentes, comandos demorados,execefile, outras máquinas, servidor e limpeza.references/desktop.mdpassa a tratar só da janela: rótulos, painéis, abas e espaços. - Os três scripts aceitam
--helpe saem com código 2 para argumento desconhecido.
Correções
- Um terminal com o rótulo
wheree semherdr.spaceeherdr.tabdeixava de ser descrito como "fora da janela". O caso apareceu num terminal comidentity: herdr-mobile, mostrado comoherdrfy / main. --helpno localizador e no diagnóstico rodava a consulta normal; argumento desconhecido era ignorado nos dois.- O bloco de instruções mandava perguntar a superfície sempre que a pessoa não a informasse, ao contrário da regra 1 da skill. O bloco agora manda rodar o localizador, que detecta a superfície, e perguntar só quando a detecção falha ou contraria o pedido.
- A procura de executáveis no
PATHdeixa de depender do comandowhich.
Documentação
- A leitura dos sinais logo depois de lançar um agente fica num lugar só, a seção "Confirmar que a tarefa começou" de
references/orquestracao.md, com o Herdr TUI no mesmo nível de detalhe do Desktop.SKILL.md,agentes.mdeherdr-core.mdapontam para ela. - Guia: os comandos dos scripts trazem o caminho da instalação (
~/.agents/skills/herdrfy/scripts/), há um capítulo novo de problemas comuns, e os capítulos de superfícies, localização e painéis tratam do terminal aberto fora da janela. - O fluxo de publicação sai do guia de uso e vai para
CONTRIBUTING.md, junto com a regra de idioma e a validação. - README: aviso das permissões liberadas antes da instalação, comandos de atualização e remoção, instalação dos templates, exemplo da saída do localizador e do relato final, e selos de CI, versão e licença.
Build
scripts/validar.mjsvirascripts/validate.mjse reprova Markdown que ainda cite um nome anterior à 0.2.0.- Testes do localizador com
hceherdrfalsos noPATH: terminal em aba, sem rótulos de aba, sem rótulos, fora de um terminal do core, painel do TUI e falha de leitura. A suíte passa de 9 para 18 testes.
v0.1.3
Correções
- A confirmação do início da tarefa deixa de falar em "tela vazia": um agente recém-aberto pode mostrar o campo de entrada vazio antes de a tarefa do comando aparecer. O reenvio agora exige duas esperas seguidas sem a tarefa na tela.
- O diálogo de confiança da pasta passa a ser descrito como possível, não certo: numa pasta já aceita, Claude Code e Codex sobem direto.
Documentação
- Explica o campo
endeddohc wait, a equivalência entre~/.agents/skills/herdrfye os links nas pastas dos agentes, e a frase que dispensa o agente auxiliar de carregar skill em tarefa pequena.
v0.1.2
Documentação
- README, guia e referência de configuração passam a mostrar a instalação com os agentes escolhidos por
-a(-a claude-code -a codex -a opencode) e avisam que-ysem-ainstala a skill na pasta de todos os agentes que o instalador conhece.