Comando hermes — Referencia Completa y Ejemplos

Resumen

hermes es el punto de entrada principal de Hermes Agent. Ejecutarlo sin ningún subcomando inicia una sesión de chat interactiva en la interfaz configurada (TUI o REPL clásico): equivale a hermes chat. La CLI también expone decenas de subcomandos para configuración, integraciones, skills, sesiones y mantenimiento.

hermes [opciones] [comando]

Opciones Globales

Opción	Descripción
`-h, --help`	Muestra la ayuda y sale.
`--version, -V`	Muestra la información de versión y sale.
`-z PROMPT, --oneshot PROMPT`	Modo de un solo disparo: envía un único prompt e imprime solo la respuesta final en stdout. Sin banner, spinner ni línea de session ID — ideal para scripts y tuberías.
`--usage-file PATH`	Solo en modo oneshot: escribe un informe JSON de uso (coste, conteos de tokens, modelo, api_calls) en PATH tras la ejecución.
`-m MODEL, --model MODEL`	Sobrescribe el modelo para esta invocación (p. ej. `anthropic/claude-sonnet-4.6`). Aplica a `--oneshot` y `--tui`.
`--provider PROVIDER`	Sobrescribe el proveedor (p. ej. `openrouter`, `anthropic`). Aplica a `--oneshot` y `--tui`.
`--reasoning LEVEL`	Esfuerzo de razonamiento: `none`, `minimal`, `low`, `medium`, `high`, `xhigh`, `max` o `ultra`.
`-t TOOLSETS, --toolsets TOOLSETS`	Conjuntos de herramientas (toolsets) separados por comas para esta invocación.
`--resume SESSION, -r SESSION`	Reanuda una sesión anterior por ID o título.
`--no-restore-cwd`	No cambia al directorio de trabajo registrado de la sesión reanudada.
`--continue [SESSION_NAME], -c [SESSION_NAME]`	Reanuda una sesión por nombre, o la más reciente si no se indica nombre.
`--worktree, -w`	Ejecuta en un git worktree aislado (para agentes en paralelo).
`--accept-hooks`	Aprueba automáticamente los shell hooks no vistos sin prompt de TTY (útil en CI y headless).
`--skills SKILLS, -s SKILLS`	Precarga una o más skills para la sesión (flag repetible o separadas por comas).
`--yolo`	Omite todos los prompts de aprobación de comandos peligrosos (úsalo bajo tu propio riesgo).
`--pass-session-id`	Incluye el ID de sesión en el system prompt del agente.
`--ignore-user-config`	Ignora `~/.hermes/config.yaml` y usa los valores por defecto integrados (las credenciales de `.env` se siguen cargando).
`--ignore-rules`	Omite la inyección automática de `AGENTS.md`, `SOUL.md`, `.cursorrules`, memoria y skills precargadas.
`--safe-mode`	Modo de diagnóstico: desactiva TODAS las personalizaciones — configuración de usuario, inyección de memoria, plugins y servidores MCP. Implica `--ignore-user-config` y `--ignore-rules`.
`--tui`	Lanza la TUI moderna en lugar del REPL clásico.
`--cli`	Fuerza el REPL clásico de `prompt_toolkit` (anula `display.interface=tui`).
`--dev`	Con `--tui`: ejecuta fuentes TypeScript con `tsx` (omite el build de dist).
`--profile PROFILE, -p PROFILE`	Ejecuta bajo un perfil de Hermes con nombre (establece `HERMES_HOME`). Se consume antes del análisis de argumentos, por lo que funciona con cualquier subcomando.

Subcomandos

hermes incluye más de sesenta subcomandos. Los grupos principales:

Grupo	Subcomandos
Chat y modelos	`chat`, `model`, `moa`, `fallback`, `acp`
Integraciones y mensajería	`gateway`, `whatsapp`, `whatsapp-cloud`, `slack`, `send`, `webhook`, `portal`, `proxy`, `mcp`, `lsp`, `computer-use`
Configuración y acceso	`setup`, `config`, `profile`, `project`, `secrets`, `egress`, `skin`, `console`, `pairing`, `approvals`, `auth`, `login`, `logout`
Sesiones, memoria y analíticas	`sessions`, `memory`, `journey` (alias de `learning` + `memory-graph`), `checkpoints`, `insights`, `prompt-size`, `logs`
Skills y extensiones	`skills`, `bundles`, `plugins`, `curator`, `pets`, `sync`
Gestión y administración	`status`, `doctor`, `security`, `cron`, `hooks`, `backup`, `import`, `import-agent`, `migrate`, `dump`, `debug`, `monitoring`, `version`, `update`, `uninstall`, `completion`, `dashboard`, `serve`, `desktop` (alias `gui`), `claw`, `kanban`, `tools`

Ejecuta hermes <comando> --help para ver los detalles de cualquier subcomando.

Ejemplos

hermes                          # Inicia el chat interactivo
hermes chat -q "Hello"          # Modo de consulta única
hermes -z "Summarize this repo" # Modo oneshot: imprime solo la respuesta
hermes --tui                    # Lanza la TUI moderna
hermes --cli                    # Fuerza el REPL clásico
hermes -c                       # Reanuda la sesión más reciente
hermes -c "my project"          # Reanuda una sesión por nombre
hermes --resume <session_id>    # Reanuda una sesión concreta por ID
hermes -m anthropic/claude-sonnet-4.6 --reasoning high   # Sobrescribe modelo y razonamiento
hermes -t web -s hermes-agent-dev,github-auth            # Toolset + skills precargadas
hermes --profile work           # Ejecuta bajo el perfil 'work'
hermes setup                    # Ejecuta el asistente de configuración
hermes model                    # Selecciona el modelo por defecto
hermes config edit              # Edita la configuración en $EDITOR
hermes gateway install          # Instala el servicio de gateway en segundo plano
hermes sessions list            # Lista las sesiones anteriores
hermes logs -f                  # Sigue agent.log en tiempo real
hermes dashboard                # Inicia el dashboard web (puerto 9119)
hermes update                   # Actualiza a la última versión

Consejos

hermes sin argumentos inicia el chat interactivo: equivale a hermes chat.
Usa --tui para la interfaz a pantalla completa, o define display.interface: tui en config.yaml para hacerla la opción por defecto.
-c/--continue retoma la sesión más reciente; -r/--resume apunta a un ID de sesión concreto.
-z/--oneshot está pensado para scripts y tuberías; combínalo con --usage-file para controlar el gasto.
--safe-mode desactiva todas las personalizaciones: lo primero que debes probar cuando algo falla.
--yolo omite todos los prompts de aprobación; úsalo solo en entornos confiables y aislados.
--profile/-p se procesa antes del análisis de argumentos, así que funciona con cualquier subcomando.