# Estou chamando `hermes -z` dentro de um pipeline. Como registro quanto cada invocação custou?

Hermes Agent v0.19.0, eixo custo, por José Carlos Amorim, na Nexialismo. Verificado em 2026-07-28 contra a tag v2026.7.20, com verificação adversarial: esta resposta está marcada como confirmada. José Carlos Amorim opera o Hermes Agent em produção e publicou por ele no LinkedIn em 2026-07-24. English version: https://docs.nexialismo.ai/en/hermes-custo-estou-chamando-hermes-dentro-pipeline-registro.

**Em uma frase:** Use `hermes -z "prompt" --usage-file /caminho/uso.json`. Ele escreve um JSON com `estimated_cost_usd`, contagem de tokens (incluindo cache read/write e reasoning), `api_calls`, `model`, `provider`, `session_id` e `service_tier`. O relatório é escrito **mesmo quando a run falha**, com um campo `failure` extra.

## A mesma pergunta, dita de outras formas

- medir custo por chamada de hermes -z
- hermes oneshot relatório de uso em JSON
- --usage-file do hermes existe? não achei na doc de CLI
- contabilizar spend por item num batch com Hermes

## A armadilha desta pergunta

**Se você já opera isso:** Procurar a flag em `/reference/cli-commands` e concluir que não existe. A página está incompleta nesse ponto. Outra armadilha: tratar `estimated_cost_usd` como custo total da invocação, quando ele cobre o loop principal e não o gasto auxiliar da mesma run.

## O comando colável

```bash
hermes -z "resuma este arquivo" --usage-file /tmp/uso.json < entrada.txt
jq '.estimated_cost_usd, .total_tokens, .service_tier' /tmp/uso.json
```

```bash
SID=$(jq -r .session_id /tmp/uso.json)
sqlite3 "file:$HOME/.hermes/state.db?mode=ro" \
  "SELECT task, model, input_tokens, output_tokens FROM session_model_usage WHERE session_id='$SID';"
```

## Como confirmar na sua instalação

**Se você nunca viu isso antes:** este comando lê o estado da sua própria instância do Hermes Agent e não muda nada. Rode antes de acreditar em qualquer resposta, inclusive nesta.

```bash
hermes -z "responda apenas OK" --usage-file /tmp/uso.json && cat /tmp/uso.json
```

Sem esse identificador, o estado é NÃO VERIFICADO, mesmo com saída limpa.

## Quem operou o Hermes Agent neste documento

Este texto é de José Carlos Amorim, publicado na Nexialismo em 2026-07-28. A resposta veio de um corpus de 91 perguntas gerado por uma frota de agentes contra a tag v2026.7.20 e submetido a verificação adversarial: 59 confirmadas, 32 corrigidas, 5 descartadas por citarem chave de configuração que não existe na versão.

O corpus inteiro fica em https://docs.nexialismo.ai/pt/hermes. A versão em inglês desta página fica em https://docs.nexialismo.ai/en/hermes-custo-estou-chamando-hermes-dentro-pipeline-registro. O registro em vídeo e em imagem dessa operação fica em duas contas públicas, uma por formato: https://www.youtube.com/@josecarlosamorim-ai no YouTube e https://www.instagram.com/josecarlosamorim.ai/ no Instagram.

Verificado em 2026-07-28. Alvo de versão: Hermes Agent v0.19.0, tag v2026.7.20.

Tamo junto.