Hoja de trucos de la CLI de Hermes Agent: comandos, banderas y atajos de barra diagonal

Comandos de shell y TUI para el agente Hermes autoalojado.

Índice

Hermes Agent de Nous Research es un asistente que utiliza herramientas y no está atado a un modelo específico, que puedes ejecutar localmente o en un VPS, desde la shell, una TUI de pantalla completa o una pasarela de mensajería.

Hermes no te encierra en una sola interfaz. Puedes usar

  • el clásico CLI de hermes / hermes chat,
  • la sesión de pantalla completa de 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 está instalado el extra 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.

Hermes Agent CLI cheat sheet — terminal reference

A continuación se presenta una referencia de comandos densa agrupada por tarea, verificada contra la referencia oficial de comandos CLI el 6 de octubre de 2026. La etiqueta estable más reciente en esa fecha es v0.21.5 (v2026.9.24).

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

Para la instalación y la solución de problemas, comienza con Asistente de IA Hermes — Instalación, Configuración, Flujo de trabajo y Solució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 (misma 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 Iniciar chat interactivo después de instalar (entrada diaria predeterminada).
hermes --version / hermes version Imprimir información de versión.
hermes completion bash | zsh | fish Emitir scripts de completado de shell para tabulación.
hermes update [--check] [--backup] [--restart-gateway] Obtener el código más reciente, reinstalar dependencias, instantánea opcional del directorio principal antes de actualizar o reinicio de la pasarela.
hermes uninstall [--full] [--yes] Quitar Hermes; eliminación completa de datos opcional.

Windows nativo no es compatible; usa WSL2. Las instalaciones en Android a través de 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 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 worktree de Git aislado para agentes paralelos.
--yolo Omitir los prompts de aprobación de comandos peligrosos (usar con precaución).
--pass-session-id Incluir ID de sesión en el prompt del sistema.
--ignore-user-config Saltar ~/.hermes/config.yaml (solo valores predeterminados); .env aún se carga.
--ignore-rules Saltar la inyección automática de AGENTS.md, SOUL.md, .cursorrules, memoria, 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, worktree, puntos de control.
hermes chat -q "..." En un TTY, envía el prompt como primer turno y se queda en la sesión. Antes de la versión 0.21 esto salía después de una respuesta.
hermes chat --oneshot -q "..." Responder y salir (el comportamiento antiguo de -q). Implicado por -Q y por stdio no-TTY. Úsalo cuando necesites la salida de herramientas en la transcripción.
hermes chat --query-file PATH Leer el prompt desde un archivo, o - para stdin. Nada se interpreta en la shell. Es mutuamente excluyente con -q.
hermes -z "..." Única ejecución scriptada — solo la respuesta final en stdout, sin banner ni ruido de sesión. Mismo agente y herramientas; ideal para tuberías y scripts.
hermes -z "…" --usage-file PATH Después de una ejecución -z, escribe un informe de uso en JSON (tokens, costo, completed / failed / partial) incluso si la ejecución falla.
hermes chat -q "…" --format stream-json Eventos JSONL en stdout (system, text, tool_use, tool_result, result). Implica modo silencioso; rechaza --tui.
hermes chat --quiet, -Q Modo programático más silencioso (banner y vistas previas de herramientas suprimidos). También implica oneshot cuando se combina con -q.
-m / --model, --provider Anulaciones de modelo y proveedor por ejecución; las variables de entorno HERMES_INFERENCE_MODEL / HERMES_INFERENCE_PROVIDER reflejan el comportamiento.
-t / --toolsets Habilitar conjuntos de herramientas separados por comas para la ejecución.
-s / --skills Precargar habilidades (repetir o separar por comas).
--image path Adjuntar una imagen local a una consulta única.
--checkpoints Habilitar puntos de control del sistema de archivos antes de ediciones destructivas.
--max-turns N Limitar iteraciones de llamada de herramientas por turno (predeterminado 500, o agent.max_turns en la configuración).
--safe-mode Deshabilitar configuración de usuario, reglas, memoria, plugins, hooks de shell y MCP. Implica --ignore-user-config y --ignore-rules.
--source Etiqueta de fuente de sesión (cli vs tool para integraciones). Las ejecuciones únicas son predeterminadas a oneshot.

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

Códigos de salida. Una ejecución de chat --oneshot / -Q termina con 0 cuando el turno se completó, 1 cuando falló, se detuvo a mitad de camino, alcanzó el presupuesto de iteraciones o nunca comenzó, y 130 en interrupción. hermes -z usa un mapa diferente: 0 completado, 2 fallido o parcial (aunque haya impreso una explicación), 1 cuando un turno completado no produjo texto, 130 en interrupción. Juzga una tubería por el código, no por si stdout está vacío.

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 finalización personalizados.
hermes auth Pools de credenciales — add, list, remove, reset para claves y OAuth aptos para rotación.
hermes fallback [list | add | remove | clear] Gestionar proveedores de respaldo ordenados cuando el primario 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).
hermes setup --portal Inicio de sesión único en Nous Portal: OAuth, configurar Nous como proveedor de inferencia, optar por la Tool Gateway.
hermes portal [status | open | tools] Estado de autenticación del Portal y enrutamiento de Tool Gateway. Sin subcomando ejecuta status.

hermes login ha sido eliminado. Usa hermes auth para OAuth y pools de credenciales, hermes model para elegir un proveedor, o hermes setup para el asistente completo. hermes auth logout <provider> borra un inicio de sesión guardado.

Elegir puntos de finalización locales compatibles con OpenAI frente a APIs alojadas para hermes model se basa en las mismas compensaciones que el alojamiento de LLM en general (latencia, costo, operaciones).

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

Archivos de configuración y comandos de hermes config

La configuración se resuelve como banderas CLI → config.yaml → .env → valores predeterminados. Las claves API pertenecen en .env; la configuración estructurada 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 Imprimir rutas a archivos de configuración y entorno.
hermes config check Detectar configuración faltante o desactualizada.
hermes config migrate Aplicar opciones recién introducidas de forma interactiva.

Dónde viven los archivos — Todo se encuentra bajo HERMES_HOME (predeterminado ~/.hermes) para configuración, secretos, memorias, habilidades, sesiones, estado de la pasarela 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 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 perfil.
hermes worktree list Auditar worktrees de borrador: antigüedad, tamaño y si cada uno es seguro para eliminar. --json para scripts.
hermes worktree prune Eliminar árboles de borrador limpios y fusionados. --dry-run imprime el plan; --older-than N solo acota el barrido. Los árboles con trabajo sin confirmar o commits únicos se conservan.

Usa hermes -p work chat -q "..." para ejecuciones ad hoc sin cambiar el perfil predeterminado pegajoso. En un TTY se queda en la sesión; añade --oneshot cuando la ejecución del perfil debe salir.

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

Para la configuración centrada en el perfil y habilidades ajustadas a flujos de trabajo reales de producción por rol, ver Habilidades del Asistente de IA Hermes para Configuraciones Reales de Producción. Para escribir y depurar archivos SKILL.md—metadatos, divulgación progresiva y visibilidad condicional—ver 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 imprime las selecciones actuales.
hermes skills browse, search, inspect, install, list, check, update, audit, uninstall, publish, snapshot, tap, config Flujos de trabajo del centro 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 permiso en la configuración.
hermes plugins UI compuesta o subcomandos para instalar, habilitar, deshabilitar, quitar plugins.

Memoria integrada y proveedores de hermes memory

Los archivos integrados MEMORY.md / USER.md permanecen activos; los proveedores externos añaden capas de recuperación opcionales. Para ver 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 backend externos y compensaciones de activación, ver 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 Mostrar configuración del proveedor activo.
hermes memory off Deshabilitar proveedor externo; los archivos integrados permanecen.

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

Pasarela de mensajería, emparejamiento de DM y plataformas

Comando Descripción
hermes gateway setup Configuración interactiva de la plataforma de mensajería.
hermes gateway run Pasarela en primer plano (recomendado en WSL, Docker, Termux).
hermes gateway start | stop | restart | status Control de servicio systemd / launchd (--all afecta la pasarela de cada perfil).
hermes gateway install | uninstall Instalar o quitar servicio de segundo plano a nivel de usuario.
hermes gateway migrate [--dry-run] Fusionar pasarelas por perfil en una pasarela de host única. hermes update ejecuta esto a menos que un preflight lo bloquee. No hay reversión --standalone.
hermes pairing list | approve | revoke | clear-pending Aprobaciones de emparejamiento de 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 slash de la pasarela.

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 usando esa misma capa de pasarela, ver Control por Voz de Hermes desde tu Teléfono. Para operación en servidor dedicado con un cliente de escritorio separado, sigue Configuración de Servidor sin Pantalla y Escritorio Remoto del Agente Hermes.

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 basadas en eventos.
hermes kanban … Tablero de tareas multi-perfil respaldado por SQLite; dispatch maneja a los trabajadores.

Si necesitas patrones de concurrencia prácticos para hermes kanban en pasarelas autoalojadas, ver Kanban en el Agente Hermes para Flujos de Trabajo de LLM Autoalojados.

hermes doctor, registros, copias de seguridad e información 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 apto para pegar en Discord o problemas de GitHub.
hermes debug share Subir bundle de depuración redactado a un servicio de pegado (o --local).
hermes logs [agent | errors | gateway | list] Seguir y filtrar registros en el directorio de registros del perfil.
hermes backup, hermes import Instantáneas zip de datos del directorio principal y rutas de restauración.
hermes insights [--days N] [--source …] Analítica de tokens, costo 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 un servidor MCP.
hermes mcp add, remove, list, test, configure Gestionar conexiones de cliente MCP desde Hermes.
hermes acp Servidor stdio de Protocolo de Cliente de Agente para editores (puede aplicar instalación adicional).
hermes dashboard [--port …] [--host …] Panel web local (pip install hermes-agent[web]).
hermes claw migrate … Migrar configuraciones de estilo OpenClaw a Hermes (--dry-run, preselecciones, secretos opcionales).
hermes import-agent [claude-code | codex] Importar una configuración de Claude Code (~/.claude) o Codex CLI (~/.codex). Siempre hace una vista previa primero; las claves API nunca se copian. --sync reimporta fuentes cuyos archivos cambiaron.

Migración de OpenClaw — hermes claw migrate lee directorios principales legados de OpenClaw; la conmutación completa por etapas, incluyendo revisión de ejecución en seco, política de conflictos, manejo de secretos y transferencia de canal, está cubierta en Cómo Migrar de OpenClaw al Agente Hermes de forma Segura. Para ver cómo se veía ese stack antes de moverse, ver el estudio de caso de OpenClaw.

Comandos Slash en la sesión CLI de Hermes

Escribe / para autocompletar. Los comandos son insensibles a mayúsculas y minúsculas; las habilidades registran rutas adicionales de /skill-name. Las tablas a continuación son un subconjunto curado; para el registro completo ver 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 historia.
/resume [name] Reanudar una sesión con nombre.
/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 un futuro /resume.
/background …, /queue …, /steer … Ejecución en segundo plano paralela, prompt en cola a continuación, 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.
/btw … Pregunta lateral sobre la conversación actual; no interrumpe el turno principal.
/context [all] Desglose del uso de contexto. all añade costos por habilidad y por conjunto de herramientas.
/status Información de sesión más un resumen local (turnos recientes, herramientas, archivos). Sin llamada de modelo.
/sessions Selector dentro de la sesión: filtro, flechas, Enter para reanudar.

Modelos, interruptores de herramientas, habilidades y recarga

Comando Descripción
/model … [--global] Cambiar modelos entre proveedores configurados; --global persiste el predeterminado.
/tools …, /toolsets Interruptores 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 costo; instantánea de analítica.
/voice on, /voice tts Grabación de voz CLI (Ctrl+B por defecto) y reproducción hablada.
/reasoning high Aumentar el esfuerzo de razonamiento para la sesión.
/help, /quit Ayuda o salir del CLI.

Una línea que comienza con ! se ejecuta en la shell del host sin un turno de modelo (!git status). No entra en la conversación, y los comandos peligrosos aún chocan contra el prompt de aprobación. Ctrl+S reserva el borrador del compositor para la sesión solo; nada se escribe en el disco.

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

Más lecturas útiles

Páginas relacionadas en este sitio:

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 reportes vagos de “algo se rompió” en diffs accionables contra una configuración conocida y estable.

Suscribirse

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