Comandos de Hermes
Hermes Agent, desarrollado por Nous Research, es un marco de agentes de inteligencia artificial de código abierto enfocado en el aprendizaje continuo y la ejecución autónoma. Aunque dispone de interfaz web y conectores a plataformas de mensajería como Telegram o Discord, la consola de comandos (CLI) es el centro de control definitivo para desarrolladores, ingenieros de DevOps y administradores de sistemas.
A través de la línea de comandos puedes orquestar subagentes, estructurar memorias persistentes, administrar servidores MCP (Model Context Protocol), configurar perfiles aislados y automatizar tareas del sistema. En este artículo encontrarás una guía exhaustiva y estructurada de la CLI de Hermes Agent, organizada por familias funcionales y acompañada de ejemplos de uso real.
1. Entrada Global y Sintaxis Base
La CLI de Hermes Agent utiliza la palabra clave hermes como ejecutable principal:
hermes [opciones-globales] <comando> [subcomando/opciones]
Opciones Globales Destacadas
| Bandera / Opción | Descripción Técnica |
|---|---|
-p <nombre>, --profile <nombre> | Especifica el perfil de Hermes a utilizar en la ejecución puntual, anulando el perfil predeterminado. |
-r <sesión>,--resume <sesión> | Reanuda una conversación previa por su ID o título (usa latest para la última sesión). |
-c [nombre],--continue [nombre] | Continúa la sesión más reciente o la que coincida con el nombre indicado. |
--in <dir> | Cambia al directorio <dir> antes de iniciar o reanudar la sesión. |
-w, --worktree | Inicia la sesión dentro de un worktree de Git aislado, ideal para trabajo paralelo de agentes. |
--yolo | Omite las solicitudes interactivas de confirmación para la ejecución de comandos de terminal peligrosos. |
--tui | Fuerza el inicio de la interfaz de usuario basada en terminal (TUI) moderna. |
--cli | Fuerza el modo REPL clásico basado en consola. |
-V, --version | Muestra la versión instalada de Hermes Agent. |
2. Invocación de Chat y Scripting de Una Sola Línea (hermes chat y hermes -z)
Iniciar Chat Interactivo (hermes chat / hermes)
Para abrir el modo interactivo por defecto basta con ejecutar:
hermes
# o explícitamente:
hermes chat
Si deseas sembrar una pregunta inicial y mantener la sesión abierta en tu terminal, utiliza -q / --query:
hermes chat -q "Analiza los últimos commits del repositorio y haz un resumen"
Scripting Ligero sin Interacción (hermes -z)
Para llamadas dentro de scripts de Bash, tuberías (pipes) o sistemas de CI/CD, el comando hermes -z ejecuta una única consulta y devuelve únicamente la respuesta en texto plano a stdout (sin banners, intros ni previsualización de herramientas):
# Capturar la respuesta directamente en una variable
RESPUESTA=$(hermes -z "Resume el archivo README.md" < README.md)
# Ejecutar con un modelo específico y generar reporte de costos/tokens
hermes -z "Revisa la sintaxis de este archivo" --provider openrouter --model openai/gpt-4o-mini --usage-file usage.json
3. Configuración del Agente y Modelos (hermes setup, hermes model, hermes config)
Asistente Completo de Configuración (hermes setup)
Guía de forma interactiva en la elección del proveedor de LLM, las claves de API, las plataformas de mensajería y las herramientas:
# Asistente interactivo completo
hermes setup
# Configuración rápida mediante OAuth con Nous Portal y Tool Gateway
hermes setup --portal
# Reconfiguración rápida (solo pregunta por valores no configurados o faltantes)
hermes setup --quick
Configuración Interactiva de Modelos vs. Comando /model
Es crucial entender la diferencia entre el comando del sistema de archivos y el comando slash en chat:
hermes model(desde tu terminal): Lanza el asistente interactivo completo. Permite añadir nuevos proveedores (OpenRouter, Anthropic, Ollama, DeepSeek, etc.), ejecutar flujos OAuth e ingresar API keys./model(dentro de la conversación de chat): Permite cambiar al instante entre modelos ya configurados previamente.
# Configurar proveedores y credenciales en tu sistema
hermes model
# Dentro del chat de Hermes:
> /model openrouter:anthropic/claude-sonnet-4
Gestión Directa de Configuración (hermes config)
Muestra, consulta o modifica el archivo principal ~/.hermes/config.yaml:
# Ver un valor de configuración específico
hermes config get model.default
# Asignar un modelo o parámetro en config.yaml
hermes config set model.default anthropic/claude-opus-4
# Abrir el archivo config.yaml en tu editor predeterminado
hermes config edit
4. Gestión de Perfiles Multitarea (hermes profile)
Hermes permite instanciar perfiles totalmente aislados, cada uno con su propio historial de conversaciones, memoria (MEMORY.md), personalidades (SOUL.md), herramientas habilitadas y archivos de configuración en ~/.hermes/profiles/<nombre>/.
# Listar todos los perfiles disponibles en el sistema
hermes profile list
# Crear un perfil nuevo clonando las herramientas y ajustes del perfil actual
hermes profile create investigador --description "Especialista en OSINT y búsqueda web" --clone
# Fijar un perfil como el predeterminado
hermes profile use investigador
# Ver los detalles y la ruta en disco del perfil
hermes profile show investigador
# Ejecutar una consulta puntual usando un perfil específico
hermes -p investigador chat -q "¿Cuáles son las noticias más recientes sobre LLMs?"
5. El Sistema de Skills (hermes skills y hermes bundles)
Las Skills son paquetes de instrucciones declarativas en formato Markdown (SKILL.md) que enseñan al agente metodologías de trabajo paso a paso.
# Explorar e instalar habilidades desde el registro oficial o de la comunidad
hermes skills browse
hermes skills search react --source skills-sh
hermes skills install official/security/1password
# Inspeccionar el contenido de una habilidad antes de instalarla
hermes skills inspect official/research/duckduckgo-search
# Listar todas las habilidades instaladas localmente
hermes skills list
# Comprobar y actualizar habilidades con cambios del repositorio de origen
hermes skills check
hermes skills update
# Desinstalar una habilidad
hermes skills uninstall 1password
Agrupación de Habilidades (hermes bundles)
Permite combinar varias habilidades bajo un único comando slash corto:
# Crear un paquete que agrupe tres habilidades
hermes bundles create backend-dev \
--skill github-code-review \
--skill test-driven-development \
--skill github-pr-workflow \
-d "Flujo completo de desarrollo backend"
# Invocación en chat:
> /backend-dev Refacciona el middleware de autenticación
6. Integración de Servidores MCP (hermes mcp)
El Model Context Protocol (MCP) permite que Hermes se conecte a servidores de herramientas externos (GitHub, PostgreSQL, sistemas de archivos, navegadores web, etc.).
# Abrir el catálogo interactivo para instalar MCPs verificados por Nous
hermes mcp
# Instalar un MCP directamente desde el catálogo oficial
hermes mcp install deepwiki
# Conectar un servidor MCP local basado en stdio en una sola línea
hermes mcp add mi-proyecto --command "npx" --args "-y" "@modelcontextprotocol/server-filesystem" "/ruta/al/proyecto"
# Probar la conectividad con un servidor MCP configurado
hermes mcp test filesystem
# Iniciar Hermes como un servidor MCP para que otros agentes (Claude Code, Cursor) lo consuman
hermes mcp serve
7. Gestión de Plugins de Sistema (hermes plugins)
A diferencia de las Skills (que son instrucciones de texto), los Plugins son módulos ejecutables en Python que extienden las capacidades nativas del motor (herramientas, ganchos del ciclo de vida o proveedores de memoria).
# Abrir el menú interactivo para activar/desactivar plugins
hermes plugins
# Instalar un plugin desde el catálogo oficial o desde GitHub
hermes plugins install observability/langfuse
# Activar o desactivar un plugin instalado
hermes plugins enable disk-cleanup
hermes plugins disable disk-cleanup
# Auditar la integridad y manifest de un plugin
hermes plugins doctor
8. Pasarela de Mensajería Multi-Plataforma (hermes gateway y hermes send)
Hermes puede funcionar como un demonio residente (daemon) conectado a plataformas como Telegram, Discord, Slack, WhatsApp, Signal o Email.
Administración del Servicio Gateway
# Configuración interactiva de canales de mensajería (tokens de bots, webhook, etc.)
hermes gateway setup
# Iniciar el servicio en segundo plano (vía systemd o launchd)
hermes gateway start
# Ejecutar el gateway en primer plano (recomendado en WSL o entornos Docker)
hermes gateway run
# Ver el estado del servicio y los canales activos
hermes gateway status
# Reiniciar todos los gateways de todos los perfiles a la vez
hermes gateway restart --all
Envíos Unidireccionales sin LLM (hermes send)
Permite enviar alertas o mensajes formateados a un canal conectado sin consumir tokens de IA, ideal para cronjobs o scripts de CI/CD:
# Enviar un mensaje directo a Telegram reutilizando las credenciales del gateway
hermes send --to telegram:-1001234567890 "Despliegue finalizado con éxito en producción."
# Enviar el contenido de un archivo de log a un canal de Discord
hermes send --to discord:#alertas --file /var/log/syslog
9. Orquestación Multi-Agente con Kanban (hermes kanban)
Hermes Agent incluye un tablero Kanban interno compartido en SQLite (~/.hermes/kanban.db) para coordinar el trabajo paralelo entre múltiples perfiles trabajadores.
# Inicializar la base de datos del tablero Kanban
hermes kanban init
# Crear un nuevo tablero dedicado para un proyecto específico
hermes kanban boards create desarrollo-web --switch
# Crear una tarea asignada a un perfil trabajador
hermes kanban create "Implementar autenticación JWT" --assignee coder --priority 1
# Listar las tareas del tablero activo
hermes kanban list
# Marcar tareas como completadas o bloqueadas desde la consola
hermes kanban complete t_abc123 --result "PR fusionado correctamente"
hermes kanban block t_def456 "Esperando credenciales de la API"
# Transmisión en tiempo real de todos los eventos del tablero en consola
hermes kanban watch
10. Diagnóstico, Mantenimiento y Respaldos
| Comando | Función Principal y Ejemplo de Uso |
|---|---|
hermes doctor | Realiza un diagnóstico completo de dependencias, permisos, bases de datos y claves de API. Añade --fix para reparar problemas automáticamente.hermes doctor --fix |
hermes status | Muestra el estado operativo general, modelo activo, backend de terminal y canales conectados.hermes status --deep |
hermes dump | Genera un resumen compacto de la configuración para compartir al pedir ayuda en soporte o foros.hermes dump --show-keys |
hermes logs | Muestra o sigue en tiempo real los archivos de registro (agent.log, errors.log, gateway.log).hermes logs errors --follow |
hermes backup | Crea un archivo comprimido .zip con la configuración, memorias y datos de Hermes.hermes backup -o ~/backup-hermes.zip |
hermes import | Restaura una copia de seguridad generada previamente.hermes import ~/backup-hermes.zip --force |
hermes update | Descarga la última versión del repositorio, actualiza dependencias y reinicia los servicios activos.hermes update |
11. Resumen de Comandos Slash (/slash) Dentro del Chat
Cuando estás en una sesión interactiva (ya sea en la consola o en un chat de Telegram/Discord), dispones de atajos directos:
/newo/reset: Inicia una conversación completamente nueva desde cero./model [proveedor:modelo]: Cambia el modelo de lenguaje en caliente./skills: Muestra y explora las habilidades disponibles en la sesión./personality [nombre]: Cambia el tono de voz o identidad del agente (concise,technical,teacher,kawaii, etc.)./compress: Fuerza la compresión y resumen del historial de la sesión para liberar espacio en la ventana de contexto./retry: Elimina el último turno y vuelve a intentar la solicitud./rollback: Vuelve al estado del sistema de archivos anterior mediante checkpoints de Git./usage: Muestra las cuotas y consumo de tokens acumulados.
Dos tablas resumen de los comandos de Hermes
Acerca del autor
