Ficha rápida de la interfaz de línea de comandos (CLI) de Hermes Agent: comandos, banderas y atajos con barra diagonal

Comandos de Shell y TUI para el agente Hermes autoalojado.

Índice

El agente Hermes de Nous Research es un asistente agnóstico de modelos y con capacidad de uso de herramientas que puede ejecutar de forma local o en un VPS.

Hermes no te encierra en una única interfaz. Puedes usar

  • la CLI clásica hermes / hermes chat,
  • la sesión de pantalla completa hermes --tui,
  • un hermes gateway de larga duración para Telegram, Discord, Slack y otras plataformas de mensajería,
  • hermes dashboard para una interfaz de usuario en el navegador local cuando se ha instalado el paquete adicional de web.

Esas rutas comparten la misma configuración y datos bajo ~/.hermes; esta página enumera los comandos de shell que importan en esos modos.

Hojas de referencia de la CLI de Hermes — referencia de terminal

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

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

Para la instalación y la resolución de problemas, empieza con Hermes AI Assistant — Instalación, configuración, flujo de trabajo y resolución de problemas.

El instalador obtiene el repositorio, configura un entorno de Python y conecta el ejecutable hermes. Después de source ~/.bashrc o ~/.zshrc, tu punto de entrada predeterminado para el chat interactivo es simplemente hermes (mismas familia 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 Inicia el chat interactivo después de la instalación (entrada diaria predeterminada).
hermes --version / hermes version Muestra información de versión.
hermes completion bash | zsh | fish Emite scripts de finalización de shell para la finalización con pestaña.
hermes update [--check] [--backup] [--restart-gateway] Obtiene el último código, reinstala dependencias, snapshot opcional del home antes de la actualización o reinicio del gateway.
hermes uninstall [--full] [--yes] Elimina Hermes; eliminación completa opcional de datos.

Windows nativo no es compatible; usa WSL2. Las instalaciones en Android vía Termux siguen una ruta dedicada en la documentación de origen.

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 Selecciona el perfil de Hermes para esta ejecución (sobrescribe el predeterminado pegajoso de hermes profile use).
--resume, -r Reanuda una sesión por ID o título.
--continue [name], -c Continúa la última sesión, o la última que coincida con un título.
--worktree, -w Inicia en un worktree de Git aislado para agentes paralelos.
--yolo Omite los avisos de aprobación de comandos peligrosos (úselo con cuidado).
--pass-session-id Incluye el ID de sesión en el prompt del sistema.
--ignore-user-config Omite ~/.hermes/config.yaml (solo valores predeterminados); .env se sigue cargando.
--ignore-rules Omite la inyección automática de AGENTS.md, SOUL.md, .cursorrules, memoria y habilidades precargadas.
--tui Inicia la TUI (equivalente a HERMES_TUI=1).
--dev Con --tui, ejecuta fuentes TS vía tsx para el desarrollo de la TUI.

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

hermes chat, prompts de un solo uso y hermes -z

Comando / patrón Descripción
hermes chat Chat interactivo o con script; superficie principal para -q, -m, --provider, conjuntos de herramientas, reanudación, worktree, puntos de control.
hermes chat -q "..." Prompt de un solo uso (no interactivo); mantiene una salida más rica que -z cuando se ejecutan herramientas.
hermes -z "..." Un solo uso con script — 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 previsualizaciones de herramientas suprimidas).
-m / --model, --provider Sobrescripciones de modelo y proveedor por ejecución; las variables de entorno HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER imitan el comportamiento.
-t / --toolsets Habilita conjuntos de herramientas separados por comas para la ejecución.
-s / --skills Precarga habilidades (repetidas o separadas por comas).
--image path Adjunta una imagen local a una consulta única.
--checkpoints Habilita puntos de control del sistema de archivos antes de ediciones destructivas.
--max-turns N Limita las iteraciones de llamadas a herramientas por turno (predeterminado de la configuración).
--source Etiqueta de origen de la sesión (cli frente a tool para integraciones).

Modelo de Hermes fuera de la sesión vs /model dentro de ella — Ejecutar hermes model desde el shell es donde se añaden proveedores, claves y OAuth. Slash /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 de acceso personalizados.
hermes auth Pools de credenciales — add, list, remove, reset para claves y OAuth aptos para rotación.
hermes fallback [list | add | remove | clear] Gestiona proveedores de respaldo ordenados cuando el principal tiene errores o 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 — usa hermes auth y hermes model en su lugar.

Elegir puntos de acceso locales compatibles con OpenAI frente a APIs alojadas para hermes model presenta las mismas compensaciones que el alojamiento general de LLMs (latencia, coste, operaciones).

Una vez que tu predeterminado termina en Qwen o Gemma en algo como Ollama, los valores predeterminados del muestreo importan tanto como el ID de modelo que escribiste; los conjuntos predeterminados de temperatura y penalización orientados a agentes se agrupan en Parámetros de inferencia LLM agentic para Qwen y Gemma.

Archivos de configuración y comandos hermes config

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

Comando Descripción
hermes config show Muestra la configuración efectiva.
hermes config edit Abre config.yaml en $EDITOR.
hermes config set key value Establece valores (los secretos van a .env, los no secretos a YAML).
hermes config path / hermes config env-path Muestra las rutas a los archivos de configuración y entorno.
hermes config check Detecta configuraciones faltantes o desactualizadas.
hermes config migrate Aplica opciones recién introducidas interactivamente.

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 Lista sesiones recientes.
hermes sessions browse Selector interactivo con búsqueda y reanudación.
hermes sessions export Exporta sesiones (por ejemplo, JSONL).
hermes sessions delete, prune, rename, stats Elimina una sesión, poda las antiguas, renombra títulos, muestra estadísticas del almacén.
hermes profile list | use | create | delete | show | rename Gestiona instancias aisladas de Hermes en una sola máquina.
hermes profile export / import Archiva o restaura un archivo tarball de perfil.
hermes profile alias Scripts envoltorios cortos para cambiar de perfil rápidamente.

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

Centro de habilidades, conjuntos de herramientas, ganchos de shell y plugins

Para la configuración centrada en el perfil y habilidades ajustadas a flujos de trabajo de producción reales por rol, consulta Habilidades del Asistente Hermes AI 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 del Agente Hermes — Estructura y Mejores Prácticas de SKILL.md.

Comando Descripción
hermes tools Habilitación interactiva de herramientas por plataforma; --summary muestra las elecciones actuales.
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config Flujos de trabajo del centro 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 Ganchos de shell declarados y listas de autorización en la configuración.
hermes plugins Interfaz compuesta o subcomandos para instalar, habilitar, deshabilitar y eliminar plugins.

Memoria integrada y proveedores hermes memory

Los archivos integrados MEMORY.md / USER.md permanecen activos; los proveedores externos añaden capas de recuperación opcionales. Para saber cómo se comporta 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 compensaciones de activación, consulta Proveedores de Memoria para Agentes Comparados — Honcho, Mem0, Hindsight y cinco más.

Comando Descripción
hermes memory setup Configuración interactiva del proveedor de memoria externo.
hermes memory status Muestra la configuración del proveedor activo.
hermes memory off Deshabilita el proveedor externo; los archivos integrados permanecen.

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

Gateway de mensajería, emparejamiento de MD 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 el gateway de cada perfil).
hermes gateway install | uninstall Instala o elimina el servicio de segundo plano a nivel de usuario.
hermes pairing list | approve | revoke | clear-pending Aprobaciones de emparejamiento de MD para bots de mensajería.
hermes whatsapp Flujo de emparejamiento del puente WhatsApp.
hermes slack manifest Genera el manifiesto de la aplicación Slack con paridad de slash del gateway.

En WSL, hermes gateway run dentro de tmux es el patrón resiliente cuando gateway start se comporta de manera incorrecta. Para flujos de trabajo de teléfono de extremo a extremo usando esa misma capa de gateway, consulta Control de Voz de Hermes desde tu Teléfono. Para la operación de servidor dedicado con un cliente de escritorio separado, sigue Configuración de Servidor Sin Cabeza y Escritorio Remoto del Agente Hermes.

Programador Cron, webhooks y Kanban

Comando Descripción
hermes cron … Crea, edita, pausa, reanuda, ejecuta y elimina prompts programados (tick para una pasada manual del programador).
hermes webhook subscribe, list, remove, test Rutas de webhook dinámicas para ejecuciones basadas en eventos.
hermes kanban … Tablero de tareas multiprofil respaldado por SQLite; dispatch maneja a los trabajadores.

Si necesitas patrones de concurrencia prácticos para hermes kanban en gateways autoalojados, consulta Kanban en el Agente Hermes para Flujos de Trabajo de LLM Autoalojados.

hermes doctor, registros, copia de seguridad y análisis de uso

Comando Descripción
hermes doctor [--fix] Diagnóstico interactivo 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 amigable para pegar en problemas de Discord o GitHub.
hermes debug share Sube un bundle de depuración redactado a un servicio de pegado (o --local).
hermes logs [agent | errors | gateway | list] Rastrea y filtra registros en el directorio de registros del perfil.
hermes backup, hermes import Snapshots zip de datos de home y rutas de restauración.
hermes insights [--days N] [--source …] Analítica de tokens, costes 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 Ejecuta Hermes como un servidor MCP.
hermes mcp add, remove, list, test, configure Gestiona conexiones de cliente MCP desde Hermes.
hermes acp Servidor stdio de Protocolo de Cliente de Agente para editores (puede aplicar una instalación adicional).
hermes dashboard [--port …] [--host …] Panel web local (pip install hermes-agent[web]).
hermes claw migrate … Migra configuraciones de estilo OpenClaw a Hermes (--dry-run, preselecciones, secretos opcionales).

Migración de OpenClaw — hermes claw migrate lee directorios home legados de OpenClaw; la transición completa por etapas, incluida la revisión de simulación, la política de conflictos, el manejo de secretos y la transferencia de canal, se cubre en Cómo Migrar de OpenClaw al Agente Hermes de Forma Segura. Para cómo era ese stack antes de la migración, consulta el estudio de caso de OpenClaw.

Comandos slash en la sesión CLI de Hermes

Escribe / para la autocompletar. Los comandos son no sensibles a mayúsculas y minúsculas; las habilidades registran rutas adicionales /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] Reanuda una sesión con nombre.
/compress [focus] Compresión manual de contexto con tema de enfoque opcional.
/retry, /undo Reintenta el último turno o descarta el último intercambio.
/title … Nombra la sesión para un /resume posterior.
/background …, /queue …, /steer … Ejecución paralela en segundo plano, siguiente prompt en cola, ajuste a mitad de bucle después de la siguiente herramienta.
/goal … Objetivo persistente de varios turnos con bucle de juez (status, pause, resume, clear).
/branch, /fork Ramifica la conversación para una exploración alternativa.

Modelos, activadores de herramientas, habilidades y recarga

Comando Descripción
/model … [--global] Cambia modelos entre proveedores configurados; --global persiste el predeterminado.
/tools …, /toolsets Activadores de herramientas de sesión y lista de conjuntos de herramientas.
/skills … Busca, instala y gestiona habilidades desde el chat.
/cron … Interfaz de tareas programadas desde la sesión CLI.
/reload-mcp Recarga los servidores MCP desde la configuración.
/reload Recarga .env en la sesión en ejecución sin reiniciar.

Uso, ayuda y salida

Comando Descripción
/usage, /insights Visibilidad de tokens y costes; instantánea de analítica.
/help, /quit Ayuda o salir de la CLI.

Las aplicaciones de mensajería (Telegram, Discord, Slack y otras) exponen un conjunto de slash superpuesto más /approve, /restart, /commands y asistentes relacionados solo de gateway — las diferencias de plataforma están documentadas en la referencia de comandos slash bajo Documentación Oficial del Agente Hermes 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 del Agente Hermes

Documentación de origen 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 frente a una configuración conocida y correcta.

Suscribirse

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