Hermes Agent: Linha de Comando (CLI)

Última atualização: 2026-08-31

A CLI é a forma mais poderosa de operar o Hermes Agent — todas as funcionalidades podem ser acessadas por linha de comando, com suporte a integração com scripts, operações em lote e pipelines de automação.

📋 Pré-requisitos: Lição 2 — Instalação, Lição 3 — Arquivos de Configuração

1. O Que Você Vai Aprender

2. História

(1) Problema: Toda Vez Operação Manual

Bob diariamente: abre Hermes → troca modelo → começa conversa → salva resultado → envia notificação. 5 passos manuais, chato e fácil de esquecer.

(2) Solução: Um Comando Resolve

Alice escreveu um script executado automaticamente todo dia:

#!/bin/bash
# daily-workflow.sh
hermes chat --model gpt-4o --skill daily-briefing --output report.md
hermes notify telegram --file report.md
hermes checkpoint save "daily-$(date +%Y%m%d)"

3. Visão Geral dos Comandos CLI

(1) Categorias de Comandos

4. Comandos Principais Detalhados

(1) hermes chat

hermes chat
hermes chat --model gpt-4o
hermes chat --user alice
hermes chat --skill code-review
hermes chat --message "Revise src/main.py" --no-interactive
cat error.log | hermes chat --message "Analise este log de erros"
hermes chat --toolset frontend-dev
hermes chat --output report.md

(2) hermes run

hermes run "Busque as novidades do React 19 e gere um resumo"
hermes run --model gpt-4o --skill research "Pesquise mudanças do Vue 4"
hermes run --delegate --max-sub-agents 3 "Revise a qualidade do código do projeto inteiro"
hermes run --format json "Analise o formato de resposta desta API"

(3) hermes serve

hermes serve --host 0.0.0.0 --port 8080
hermes serve --daemon
hermes serve --config /path/to/config.yaml
hermes serve --platforms telegram,discord,slack

5. Comandos de Conversa e Interação

(1) Comandos na Conversa

Em hermes chat modo interativo, comandos começam com /:

(2) Atalhos na Conversa

6. Comandos de Gerenciamento e Operações

(1) Gerenciamento de Configuração

hermes config show
hermes config get model.default
hermes config set model.default gpt-4o
hermes config validate
hermes config export > backup.yaml
hermes config import backup.yaml
hermes config reset

(2) Gerenciamento de Modelos

hermes model list
hermes model test gpt-4o
hermes model add --name my-model --provider ollama
hermes model info gpt-4o

(3) Health Check

hermes doctor
hermes health
hermes --version
hermes info

7. Integração com Scripts e Automação

(1) Integração com Shell Script

#!/bin/bash
# CI/CD integration

hermes run --skill code-review --output review.md "Revise PR #$PR_NUMBER"

if grep -q "🔴 Crítico" review.md; then
  echo "Problema crítico encontrado, bloqueando merge"
  exit 1
fi

hermes run --skill test-runner "Execute suite de testes completa"
hermes run --model gpt-4o --output CHANGELOG.md "Gere notas de release baseado no git log"

(2) Integração com Python

from hermes import HermesClient

client = HermesClient(base_url="http://localhost:8080")

response = client.chat(
    message="Revise a qualidade do código deste arquivo",
    model="gpt-4o",
    files=["src/main.py"]
)

print(response.text)

results = client.batch_run([
    {"message": "Busque React 19", "model": "gpt-4o-mini"},
    {"message": "Busque Vue 4", "model": "gpt-4o-mini"},
    {"message": "Busque Svelte 5", "model": "gpt-4o-mini"},
])

for r in results:
    print(f"Task: {r.task}, Cost: ${r.cost:.4f}")

(3) Integração com Makefile

.PHONY: review test deploy

review:
	hermes run --skill code-review "Revise todos os arquivos modificados"

test:
	hermes run --skill test-runner "Execute suite de testes"

deploy: review test
	hermes run "Deploy para ambiente de staging"
	@echo "Deploy completo"

❓ Perguntas Frequentes

P: CLI suporta Windows? R: Sim. PowerShell e CMD funcionam. Alguns recursos de pipe funcionam melhor no WSL2.

P: Como ver ajuda de comandos? R: hermes --help para ajuda global, hermes chat --help para subcomandos.

P: Modo não-interativo para quais cenários? R: Integração com scripts, CI/CD, tarefas agendadas, processamento em lote. Automação sem interação humana.

P: Como executar múltiplas tarefas em paralelo? R: Shell background hermes run ... & ou Python multithread. CLI suporta --delegate para paralelismo.

P: Onde ficam os logs da CLI? R: Padrão ~/.hermes/logs/. hermes chat --verbose mostra logs detalhados em tempo real.

P: Como depurar problemas da CLI? R: hermes chat --debug ativa modo debug, mostrando chamadas de ferramentas e requisições de modelo completas.

📖 Resumo

• CLI cobre 100% das funcionalidades, a forma mais eficiente para desenvolvedores
• hermes chat para conversa, hermes run para tarefa única, hermes serve para serviço API
• Comandos / na conversa: habilidades, memória, modelo, checkpoints
• Comandos de gerenciamento: config, model, health, doctor
• Integração com scripts: Shell, Python, Makefile para pipelines de automação

📝 Exercícios

1. Básico (⭐): Use a CLI para um fluxo completo: inicializar → conversar → salvar checkpoint → ver custo.
2. Intermediário (⭐⭐): Escreva um Shell script que usa hermes run para automatizar revisão de código + testes + gerar relatório.
3. Avançado (⭐⭐⭐): Desenvolva um workflow automatizado com Python HermesClient: pull diário de logs Git → gerar relatório diário → enviar notificação, integrado ao cron.

Equipe Técnica Web-Tutorial

Uma plataforma de tutoriais mantida por diversos desenvolvedores. Cada tutorial é escrito e revisado por profissionais da área correspondente. Trabalhamos para manter nosso conteúdo preciso e confiável — se encontrar algum problema, avise-nos.

Sobre Nós