@omatheusdaia/hermes-gtm

Hermes GTM Operator é uma skill modular para transformar o Hermes Agent em uma rotina de pesquisa, qualificação e outbound controlado. O default é seguro: research_only, ações externas desativadas e aprovação humana obrigatória.

Instalação

npx @omatheusdaia/hermes-gtm install

O pacote carrega a skill inteira dentro do próprio tarball e copia a árvore para ~/.hermes/skills/hermes-gtm-operator. Ele não baixa SKILL.md por URL, não instala o Hermes e não pede segredos.

Primeiro acesso completo

O runtime Hermes precisa ser instalado separadamente. A skill orienta o usuário com os instaladores oficiais, hermes setup --portal, instalação de skills companheiras, preenchimento de oferta/ICP, configuração de fonte/revisão/CRM, demo local e testes de reply, bounce, unsubscribe, duplicata, expiração e falha.

O gate inicial mantém research_only, e-mail/LinkedIn desligados e aprovação humana obrigatória. Ele só libera a próxima integração depois de confirmar o teste da anterior. Veja skill/hermes-gtm-operator/workflows/first-access.md.

npx @omatheusdaia/hermes-gtm install --dry-run
npx @omatheusdaia/hermes-gtm install --yes
npx @omatheusdaia/hermes-gtm install --path /caminho/para/.hermes/skills/hermes-gtm-operator
npx @omatheusdaia/hermes-gtm init
npx @omatheusdaia/hermes-gtm doctor
npx @omatheusdaia/hermes-gtm update --yes
npx @omatheusdaia/hermes-gtm uninstall --yes

update cria backup e preserva os YAMLs existentes. uninstall remove somente hermes-gtm-operator e nunca o Hermes.

Demo sem APIs pagas

Depois de instalar, rode:

node ~/.hermes/skills/hermes-gtm-operator/scripts/demo.mjs
node ~/.hermes/skills/hermes-gtm-operator/scripts/demo.mjs --format csv

Os registros são fictícios e têm demo: true. Não use os domínios demo em outreach real.

Uso no Hermes

Abra uma nova sessão e diga Configure meu agente GTM.. O onboarding pergunta uma coisa por vez, salva configurações locais e permanece em pesquisa até nova autorização. Exemplos: Encontre 20 empresas para minha oferta, Pesquise os decisores dessas contas, Prepare mensagens, mas não envie e Mostre minha fila de aprovação.

Integrações

CSV e demo local não precisam de credencial. A skill acompanha o status e o teste de pesquisa web, Apollo, Clay, Crustdata, Telegram, HubSpot, Smartlead e Unipile. Os adaptadores externos continuam not_implemented até haver código, documentação oficial, permissões, limites e testes reais. O pacote não finge conectores.

Desenvolvimento e publicação

cd packages/hermes-gtm
npm run build
npm test
npm pack --dry-run
npm publish --access public

Para testar localmente o tarball:

TARBALL=$(npm pack --silent)
mkdir -p /tmp/hermes-gtm-smoke && cd /tmp/hermes-gtm-smoke
npm install /caminho/absoluto/$TARBALL
npx @omatheusdaia/hermes-gtm install --dry-run --path "$PWD/.hermes/skills/hermes-gtm-operator"

O pacote usa o scope público @omatheusdaia e a conta precisa ter permissão de publicação. A primeira publicação de um scoped package público deve usar --access public; 2FA ou um token granular com bypass de 2FA são responsabilidade do mantenedor e nunca devem ser colados em chat ou commit.