Sobre o projeto
O herdr-mise é um visualizador em localhost que retrata agentes de programação de IA como cozinheiros de linha em pixel art trabalhando numa única cozinha de restaurante. O estado do agente, o trilho de tickets, o balcão de entrega, o quadro 86 e as luzes da cozinha formam uma camada visual de leitura rápida sobre um pequeno feed JSON versionado. O projeto afirma claramente que não controla agentes, não renderiza a saída deles nem agrega servidores remotos: é uma janela, não um escritório.
O que é
- Um único binário estático que serve um cliente TypeScript no navegador em http://127.0.0.1:8686 e, com --tui, uma cozinha nativa no terminal.
- Uma projeção somente leitura do estado local do Herdr. Não aprova, não envia prompts, não encerra nem inspeciona a saída dos agentes.
- Uma ferramenta de máquina única, não um painel remoto, caixa de entrada de notificações, registro de sessão ou agregador de múltiplos hosts.
Modos de execução
- Demo: cozinheiros determinísticos permanecem visivelmente rotulados enquanto o servidor tenta novamente uma fonte Herdr ausente, com tempo esgotado, não suportada ou incompatível.
- Live: um snapshot compatível substitui atomicamente a escalação de demo sem reiniciar o processo ou o navegador.
- Disconnected: o silêncio do navegador exibe o estado GAS LEAK — SERVICE SUSPENDED e depois reconecta por meio de um snapshot novo.
- Empty: uma fonte ao vivo sem agentes mostra uma mensagem de espera.
Instalação
- Plugin do Herdr: brew install herdr, depois herdr plugin install funsaized/herdr-mise e então invoque a ação open. O instalador baixa um binário de release fixado e verificado; Node, npm, Cargo e Rust não são exigidos para os usuários.
- Standalone: use um script de instalação via curl e execute com --tui.
- Homebrew/Linuxbrew: brew install funsaized/tap/herdr-mise. Isso instala a dependência herdr, mas não registra um plugin do Herdr.
Compatibilidade
Uma matriz verificada mapeia releases do Herdr (0.7.5 a 0.9.0) aos protocolos de snapshot 17 a 22. A autoridade é compatibility/herdr.json, e um script de verificação valida o runtime, a documentação, os fixtures e a privacidade dos fixtures.
Desenvolvimento
O desenvolvimento local usa um playground determinístico apenas no cliente (npm run dev:visual) para o trabalho visual, e uma etapa de bundle compila o cliente embutido e o binário de release para o trabalho de integração. No desenvolvimento de plugins para contribuidores, é possível vincular um checkout com herdr plugin link.
Segurança e limitações
- O servidor se vincula apenas a 127.0.0.1, na porta 8686 por padrão; HERDR_MISE_PORT altera apenas essa porta de loopback. As origens de WebSocket do navegador precisam corresponder à porta efetiva ou ser adicionadas explicitamente para um proxy reverso pessoal.
- O binário não envia telemetria e não faz requisições de rede de produto para fora. O modo live lê apenas o socket Unix local do Herdr.
- Os arquivos de release e o instalador suportam macOS arm64, macOS x86_64 e Linux x86_64 glibc. Não há serviço em segundo plano nem atualização automática.
- As configurações do navegador são dados locais do site, e a preferência por movimento reduzido é respeitada.
A documentação cobre arquitetura, operações, operações de release, contribuição e uma política de segurança. O projeto se descreve como um projeto comunitário independente, não afiliado nem mantido pela equipe do Herdr.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.