Hoja de trucos de Hermes Agent CLI: comandos, banderas y accesos directos con barra

Hermes Agent de Nous Research es un asistente agnóstico al modelo y con capacidad de usar herramientas que puedes ejecutar localmente o en un VPS.

Hermes no te ata a una sola interfaz. Puedes usar:

• la clásica CLI hermes / hermes chat,
• la sesión de pantalla completa hermes --tui,
• un hermes gateway en ejecución continua para Telegram, Discord, Slack y otras plataformas de mensajería,
• hermes dashboard para una interfaz de usuario local en el navegador cuando está instalada la extensión web.

Estas opciones comparten la misma configuración y datos bajo ~/.hermes; esta página enumera los comandos de shell relevantes para todos estos modos.

A continuación se presenta una referencia densa de comandos agrupada por tareas.

Instalación de Hermes Agent y comandos CLI de primera ejecución

Para la instalación y solución de problemas, comienza con Asistente AI Hermes — Instalación, Configuración, Flujo de Trabajo y Solución de Problemas.

El instalador descarga el repositorio, configura un entorno de Python y vincula el ejecutable hermes. Después de ejecutar source ~/.bashrc o ~/.zshrc, tu punto de entrada predeterminado para el chat interactivo es simplemente hermes (del mismo grupo que hermes chat).

Comando	Descripción
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash	Instalación oficial en una línea (Linux, macOS, WSL2).
hermes / hermes chat	Iniciar chat interactivo después de la instalación (punto de entrada diario predeterminado).
hermes --version / hermes version	Imprimir información de la versión.
hermes completion bash | zsh | fish	Emitir scripts de finalización de shell para el autocompletado con tabulador.
hermes update [--check] [--backup] [--restart-gateway]	Obtener el último código, reinstalar dependencias, captura opcional del hogar previo a la actualización o reinicio del gateway.
hermes uninstall [--full] [--yes]	Desinstalar Hermes; eliminación opcional completa de datos.

Windows nativo no es compatible; usa WSL2. Las instalaciones en Android a través de Termux siguen una ruta dedicada en la documentación oficial.

Banderas globales para cada invocación de hermes

Estas banderas se aplican antes de los subcomandos y cambian qué perfil, qué sesión o cuánta configuración personal se carga.

Bandera	Descripción
--profile, -p	Seleccionar perfil de Hermes para esta ejecución (anula el predeterminado pegajoso de hermes profile use).
--resume, -r	Reanudar una sesión por ID o título.
--continue [name], -c	Continuar la sesión más reciente, o la más reciente que coincida con un título.
--worktree, -w	Iniciar en un árbol de trabajo de Git aislado para agentes paralelos.
--yolo	Omitir los prompts de aprobación para comandos peligrosos (usar con cuidado).
--pass-session-id	Incluir el ID de sesión en el prompt del sistema.
--ignore-user-config	Omitir ~/.hermes/config.yaml (solo valores predeterminados); .env aún se carga.
--ignore-rules	Omitir la autoinyección de AGENTS.md, SOUL.md, .cursorrules, memoria y habilidades precargadas.
--tui	Lanzar la TUI (equivalente a HERMES_TUI=1).
--dev	Con --tui, ejecutar fuentes TS vía tsx para desarrollo de TUI.

La automatización aislada a menudo combina hermes chat --ignore-user-config --ignore-rules con hermes -z para ejecuciones únicas reproducibles.

hermes chat, prompts únicos y hermes -z

Comando / patrón	Descripción
hermes chat	Chat interactivo o scriptado; superficie principal para -q, -m, --provider, conjuntos de herramientas, reanudación, árbol de trabajo y puntos de control.
hermes chat -q "..."	Prompt único (no interactivo); mantiene una salida más rica que -z cuando se ejecutan herramientas.
hermes -z "..."	Único scriptado — solo la respuesta final en stdout, sin banner ni ruido de sesión. Mismo agente y herramientas; ideal para tuberías y scripts.
hermes chat --quiet, -Q	Modo programático más silencioso (banner y vistas previas de herramientas suprimidos).
-m / --model, --provider	Anulaciones de modelo y proveedor por ejecución; las variables de entorno HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER replican este comportamiento.
-t / --toolsets	Habilitar conjuntos de herramientas separados por comas para la ejecución.
-s / --skills	Precargar habilidades (repetir o separadas por comas).
--image path	Adjuntar una imagen local a una consulta única.
--checkpoints	Habilitar puntos de control en el sistema de archivos antes de ediciones destructivas.
--max-turns N	Limitar las iteraciones de llamadas a herramientas por turno (predeterminado desde la configuración).
--source	Etiqueta de origen de la sesión (cli vs tool para integraciones).

Modelo de Hermes fuera de la sesión vs /model dentro de ella — Ejecutar hermes model desde la shell es donde se añaden proveedores, claves y OAuth. La barra /model solo cambia entre proveedores ya configurados. Si solo ves OpenRouter en /model, sal de la sesión y completa hermes model.

Selector de modelos, grupos de credenciales y proveedores de respaldo

Comando	Descripción
hermes model	Selector interactivo de proveedores y modelos; claves, OAuth, puntos finales personalizados.
hermes auth	Grupos de credenciales — add, list, remove, reset para claves amigables a la rotación y OAuth.
hermes fallback [list | add | remove | clear]	Gestionar proveedores de respaldo ordenados cuando el principal da error o tiene límites de tasa.
hermes setup [model | tts | terminal | gateway | tools | agent] [...]	Configuración interactiva seccionada o completa (--quick, --reset, --non-interactive).

Descontinuado hermes login / hermes logout — usa hermes auth y hermes model en su lugar.

Elegir puntos finales locales compatibles con OpenAI versus APIs alojadas para hermes model presenta los mismos compromisos que el alojamiento general de LLM (latencia, costo, operaciones).

Archivos de configuración y comandos de hermes config

La configuración se resuelve como anulaciones de CLI → config.yaml → .env → valores predeterminados. Las claves API pertenecen a .env; las configuraciones estructuradas en config.yaml.

Comando	Descripción
hermes config show	Mostrar la configuración efectiva.
hermes config edit	Abrir config.yaml en $EDITOR.
hermes config set key value	Establecer valores (secretos enrutados a .env, no secretos a YAML).
hermes config path / hermes config env-path	Imprimir rutas a archivos de configuración y entorno.
hermes config check	Detectar configuraciones faltantes o obsoletas.
hermes config migrate	Aplicar opciones recién introducidas de forma interactiva.

Dónde viven los archivos — Todo reside bajo HERMES_HOME (predeterminado ~/.hermes) para configuración, secretos, memorias, habilidades, sesiones, estado del gateway y registros.

Gestión de sesiones y hermes profile

Comando	Descripción
hermes sessions list	Listar sesiones recientes.
hermes sessions browse	Selector interactivo con búsqueda y reanudación.
hermes sessions export	Exportar sesiones (p. ej., JSONL).
hermes sessions delete, prune, rename, stats	Eliminar una sesión, podar las antiguas, renombrar títulos, mostrar estadísticas del almacén.
hermes profile list | use | create | delete | show | rename	Gestionar instancias aisladas de Hermes en una máquina.
hermes profile export / import	Archivar o restaurar un archivo tarball de un perfil.
hermes profile alias	Scripts envoltorios cortos para cambio rápido de perfiles.

Usa hermes -p work chat -q "..." para ejecuciones ad hoc sin cambiar el perfil predeterminado pegajoso.

Hub de habilidades, conjuntos de herramientas, hooks de shell y plugins

Para configuración centrada en perfiles y habilidades ajustadas a flujos de trabajo de producción reales por rol, consulta Habilidades del Asistente AI Hermes para Configuraciones de Producción Reales.

Comando	Descripción
hermes tools	Habilitación interactiva de herramientas por plataforma; --summary imprime las elecciones actuales.
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config	Flujos de trabajo del hub de habilidades incluyendo registros e instalaciones por URL.
hermes curator status, run, pause, pin, rollback, …	Mantenimiento de habilidades en segundo plano y reversión segura.
hermes hooks list, test, revoke, doctor	Hooks de shell declarados y listas de permitidos en la configuración.
hermes plugins	UI compuesta o subcomandos para instalar, habilitar, deshabilitar, eliminar plugins.

Memoria integrada y proveedores de hermes memory

Los MEMORY.md / USER.md integrados permanecen activos; los proveedores externos añaden capas de recuperación opcionales. Para saber cómo funciona esa arquitectura en la práctica, lee Sistema de Memoria del Agente Hermes — Cómo Funciona Realmente la Memoria Persistente de IA. Para comparar backends externos y compromisos de activación, consulta Proveedores de Memoria de Agentes Comparados — Honcho, Mem0, Hindsight y Cinco Más.

Comando	Descripción
hermes memory setup	Configuración interactiva del proveedor de memoria externa.
hermes memory status	Mostrar ajustes del proveedor activo.
hermes memory off	Deshabilitar proveedor externo; los archivos integrados permanecen.

Cuando un proveedor está activo, puede registrar subcomandos de nivel superior específicos del proveedor — ejecuta hermes --help para ver qué está conectado hoy.

Gateway de mensajería, emparejamiento DM y plataformas

Comando	Descripción
hermes gateway setup	Configuración interactiva de la plataforma de mensajería.
hermes gateway run	Gateway en primer plano (recomendado en WSL, Docker, Termux).
hermes gateway start | stop | restart | status	Control de servicio systemd / launchd (--all afecta al gateway de cada perfil).
hermes gateway install | uninstall	Instalar o eliminar servicio de fondo a nivel de usuario.
hermes pairing list | approve | revoke | clear-pending	Aprobaciones de emparejamiento DM para bots de mensajería.
hermes whatsapp	Flujo de emparejamiento del puente de WhatsApp.
hermes slack manifest	Generar manifiesto de aplicación de Slack con paridad de barra斜.

En WSL, hermes gateway run dentro de tmux es el patrón resiliente cuando gateway start se comporta mal.

Programador Cron, webhooks y Kanban

Comando	Descripción
hermes cron …	Crear, editar, pausar, reanudar, ejecutar, eliminar prompts programados (tick para paso manual del programador).
hermes webhook subscribe, list, remove, test	Rutas de webhook dinámicas para ejecuciones impulsadas por eventos.
hermes kanban …	Tablero de tareas multi-perfil respaldado por SQLite; dispatch impulsa trabajadores.

hermes doctor, registros, copia de seguridad e insights de uso

Comando	Descripción
hermes doctor [--fix]	Diagnóstico interactivo y reparación automática opcional.
hermes status [--all] [--deep]	Estado conciso; comprobaciones más profundas cuando sea necesario.
hermes dump [--show-keys]	Resumen de configuración amigable para pegar en Discord o problemas de GitHub.
hermes debug share	Cargar paquete de depuración anonimizado a un servicio de paste (o --local).
hermes logs [agent | errors | gateway | list]	Seguir y filtrar registros bajo el directorio de registros del perfil.
hermes backup, hermes import	Snapshots en zip de datos del hogar y rutas de restauración.
hermes insights [--days N] [--source …]	Análisis de tokens, costos y actividad.

Cuando algo se rompe después de una actualización, hermes doctor, hermes status y hermes logs errors -f forman el ciclo de triaje más rápido.

MCP, ACP, panel web y migración de OpenClaw

Comando	Descripción
hermes mcp serve	Ejecutar Hermes como servidor MCP.
hermes mcp add, remove, list, test, configure	Gestionar conexiones de cliente MCP desde Hermes.
hermes acp	Servidor stdio del Protocolo de Cliente de Agente para editores (puede aplicar instalación extra).
hermes dashboard [--port …] [--host …]	Panel web local (pip install hermes-agent[web]).
hermes claw migrate …	Migrar configuraciones estilo OpenClaw a Hermes (--dry-run, presets, secretos opcionales).

Migración de OpenClaw — hermes claw migrate lee directorios hogareños heredados de OpenClaw; para ver cómo era ese stack antes de moverse, consulta el estudio de caso de OpenClaw.

Comandos con barra en la sesión CLI de Hermes

Escribe / para autocompletado. Los comandos son insensibles a mayúsculas/minúsculas; las habilidades registran rutas extra de /skill-name. Las tablas a continuación son un subconjunto curado; para el registro completo consulta la Documentación Oficial del Agente Hermes al final de este artículo.

Flujo de sesión, tareas en segundo plano y objetivos

Comando	Descripción
/new, /reset	Nuevo ID de sesión e historial.
/resume [name]	Reanudar una sesión nombrada.
/compress [focus]	Compresión manual de contexto con tema de enfoque opcional.
/retry, /undo	Reintentar el último turno o descartar el último intercambio.
/title …	Nombrar la sesión para /resume posterior.
/background …, /queue …, /steer …	Ejecución en segundo plano paralela, siguiente prompt en cola, nudge a mitad de bucle después de la siguiente herramienta.
/goal …	Objetivo persistente de múltiples turnos con bucle de juez (status, pause, resume, clear).
/branch, /fork	Ramificar la conversación para exploración alternativa.

Modelos, toggles de herramientas, habilidades y recarga

Comando	Descripción
/model … [--global]	Cambiar modelos entre proveedores configurados; --global persiste el predeterminado.
/tools …, /toolsets	Toggles de herramientas de sesión y listado de conjuntos de herramientas.
/skills …	Buscar, instalar y gestionar habilidades desde el chat.
/cron …	UI de tareas programadas desde la sesión CLI.
/reload-mcp	Recargar servidores MCP desde la configuración.
/reload	Recargar .env en la sesión en ejecución sin reiniciar.

Uso, ayuda y salida

Comando	Descripción
/usage, /insights	Visibilidad de tokens y costos; instantánea de análisis.
/help, /quit	Ayuda o salir de la CLI.

Las aplicaciones de mensajería (Telegram, Discord, Slack y otras) exponen un conjunto superpuesto de barras más /approve, /restart, /commands y asistentes solo de gateway relacionados — las diferencias de plataforma están documentadas en la referencia de comandos con barra bajo Documentación Oficial del Agente Hermes a continuación.

Lectura adicional útil

Páginas relacionadas en este sitio (contexto más amplio para Hermes y agentes de terminal):

• Sistemas AI — Asistentes Autoalojados, RAG e Infraestructura Local — visión general del clúster y cómo encajan los asistentes en el stack
• Memoria de Sistemas AI — hub de memoria y guías adyacentes
• Herramientas de Desarrollo AI — panorama de herramientas de terminal e IDE
• Inicio Rápido de OpenCode — otro agente centrado en terminal para comparación ergonómica

Documentación Oficial del Agente Hermes

Documentación oficial en hermes-agent.nousresearch.com:

• Agente Hermes
• Referencia de comandos CLI
• Referencia de comandos con barra

---

Consejo. Mantén hermes dump y hermes doctor --fix en la memoria muscular — transforman informes vagos de “algo se rompió” en diffs accionables contra una configuración conocida como buena.