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

Comandos de Shell y TUI para el agente Hermes autoalojado.

Índice

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

Hermes no te limita a una sola interfaz. Puedes utilizar

  • la clásica línea de comandos (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 en el navegador local cuando se instala el complemento web.

Estas vías comparten la misma configuración y datos bajo ~/.hermes; esta página enumera los comandos de shell que son importantes en todos esos modos.

Referencia rápida de la CLI de Hermes Agent — referencia de terminal

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

Instalar Hermes Agent y comandos CLI de primera ejecución

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

El instalador descarga el repositorio, configura un entorno de Python y conecta el ejecutable hermes. Después de ejecutar source ~/.bashrc o ~/.zshrc, tu punto de entrada predeterminado para el chat interactivo es simplemente hermes (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 (entrada diaria predeterminada).
hermes --version / hermes version Mostrar información de la versión.
hermes completion bash | zsh | fish Emitir scripts de finalización de shell para la finalización con tabulador.
hermes update [--check] [--backup] [--restart-gateway] Obtener el último código, reinstalar dependencias, instantánea previa a la actualización del directorio principal o reinicio de la puerta de enlace (opcional).
hermes uninstall [--full] [--yes] Desinstalar Hermes; eliminación completa de datos (opcional).

Windows nativo no es compatible; utiliza 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 fijo 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 Git aislado para agentes paralelos.
--yolo Omitir los prompts de aprobación de 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 sigue cargándose.
--ignore-rules Omitir la inyección automática de AGENTS.md, SOUL.md, .cursorrules, memoria y habilidades precargadas.
--tui Iniciar la interfaz de usuario de terminal (TUI) (equivalente a HERMES_TUI=1).
--dev Con --tui, ejecutar fuentes TS vía tsx para el 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); conserva una salida más rica que -z cuando se ejecutan herramientas.
hermes -z "..." Prompt ú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 llamada 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 agregas 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, pools de credenciales y proveedores de respaldo

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

hermes login / hermes logout obsoletos — utiliza hermes auth y hermes model en su lugar.

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

Una vez que tu predeterminado termina en Qwen o Gemma en algo como Ollama, los valores predeterminados del muestreador son tan importantes como el ID del modelo que escribiste; los presets agregados de temperatura y penalización orientados a agentes se encuentran en Parámetros de inferencia de LLM agenticos para Qwen y Gemma.

Archivos de configuración y comandos hermes config

La configuración se resuelve como anulaciones 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 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 Mostrar rutas a los archivos de configuración y entorno.
hermes config check Detectar configuraciones faltantes o desactualizadas.
hermes config migrate Aplicar nuevas opciones interactivamente.

Dónde viven los archivos — Todo está bajo HERMES_HOME (predeterminado ~/.hermes) para configuración, secretos, memorias, habilidades, sesiones, estado de la puerta de enlace 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 (por ejemplo, JSONL).
hermes sessions delete, prune, rename, stats Eliminar una sesión, recortar 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 tarball de perfil.
hermes profile alias Scripts envoltorios cortos para cambio rápido de perfiles.

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

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

Para configuración primero por perfil y habilidades ajustadas a flujos de trabajo de producción reales por rol, consulta Habilidades del Asistente de IA Hermes para Configuraciones de Producción Reales. Para escribir y depurar archivos SKILL.md —metadatos, divulgación progresiva y visibilidad condicional— consulta Creación de Habilidades de Hermes Agent — Estructura de SKILL.md y Mejores Prácticas.

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, incluidos 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 Interfaz de usuario compuesta o subcomandos para instalar, habilitar, deshabilitar, eliminar plugins.

Memoria integrada y proveedores hermes memory

La MEMORY.md / USER.md integrada sigue activa; los proveedores externos agregan capas de recuperación opcionales. Para saber cómo funciona esa arquitectura en la práctica, lee Sistema de Memoria de Hermes Agent — Cómo Funciona Realmente la Memoria de IA Persistente. Para comparar backends externos y compensaciones 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 configuraciones 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.

Puerta de enlace 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 Puerta de enlace en primer plano (recomendada en WSL, Docker, Termux).
hermes gateway start | stop | restart | status Control de servicio systemd / launchd (--all afecta la puerta de enlace de cada perfil).
hermes gateway install | uninstall Instalar o eliminar servicio en segundo plano 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 WhatsApp.
hermes slack manifest Generar manifiesto de aplicación Slack con paridad de barra de puerta de enlace.

En WSL, hermes gateway run dentro de tmux es el patrón resiliente cuando gateway start se comporta mal. Para flujos de trabajo de teléfono de extremo a extremo utilizando esa misma capa de puerta de enlace, consulta Control de Voz de Hermes desde tu Teléfono. Para operación en servidor dedicado con cliente de escritorio separado, sigue Configuración de Servidor sin Escritorio y Escritorio Remoto de Hermes Agent.

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 multiperfil respaldado por SQLite; dispatch maneja trabajadores.

Si necesitas patrones de concurrencia prácticos para hermes kanban en puertas de enlace autoalojadas, consulta Kanban en Hermes Agent para Flujos de Trabajo de LLM Autoalojados.

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

Comando Descripción
hermes doctor [--fix] Diagnósticos interactivos y reparación automática opcional.
hermes status [--all] [--deep] Estado conciso; verificaciones más profundas cuando sea necesario.
hermes dump [--show-keys] Resumen de configuración fácil de pegar para 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] Seguimiento y filtrado de registros bajo el directorio de registro del perfil.
hermes backup, hermes import Instantáneas zip de datos del directorio principal y restauración de rutas.
hermes insights [--days N] [--source …] Analíticas 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 bucle 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 aplicarse instalación adicional).
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 principales heredados de OpenClaw; para ver cómo era ese stack antes de moverse, consulta el estudio de caso de OpenClaw.

Comandos de barra en la sesión de la CLI de Hermes

Escribe / para autocompletar. Los comandos son insensibles a mayúsculas y minúsculas; las habilidades registran rutas extra /skill-name. Las tablas a continuación son un subconjunto curado; para el registro completo consulta la documentación oficial de Hermes Agent 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 último turno o eliminar último intercambio.
/title … Nombrar la sesión para /resume posterior.
/background …, /queue …, /steer … Ejecución en segundo plano paralelo, siguiente prompt en cola, impulso 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, alternadores de herramientas, habilidades y recarga

Comando Descripción
/model … [--global] Cambiar modelos entre proveedores configurados; --global persiste el predeterminado.
/tools …, /toolsets Alternadores de herramientas de sesión y listado de conjuntos de herramientas.
/skills … Buscar, instalar y gestionar habilidades desde el chat.
/cron … Interfaz 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 analíticas.
/help, /quit Ayuda o salir de la CLI.

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

Más lectura útil

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

Documentación oficial de Hermes Agent

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

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

Suscribirse

Recibe nuevas publicaciones sobre sistemas, infraestructura e ingeniería de IA.