Hermes Agent: guía de comandos de CLI, sesión y configuración

[!info] Qué es Hermes Agent (Nous Research) es un asistente de IA agnóstico de modelo, de código abierto, que corre en terminal (local o VPS). Tiene memoria persistente, skills auto-generables y una pasarela (gateway) para 21+ plataformas de mensajería (Telegram, Discord, Slack, WhatsApp, Signal, Matrix…). No confundir con los modelos “Hermes 3/4” de Nous — esto es la herramienta CLI.

---

1. Comandos de terminal ([[scripts-connect-hermes-syncthing|hermes]] <comando>)

Se ejecutan desde la shell, fuera de una sesión de chat.

Comando	Qué hace
hermes chat	Chat interactivo o de una sola pregunta con el agente. Es el modo por defecto.
hermes -z "prompt"	Modo scripted: entra un prompt, sale solo el texto de respuesta final (ideal para scripts/cron).
hermes model	Asistente interactivo para añadir proveedores, hacer login OAuth y elegir modelo por defecto.
hermes moa	Configura presets de “Mixture of Agents” (combinar varios modelos).
hermes fallback	Gestiona proveedores de respaldo si el modelo principal falla.
hermes gateway	Arranca/gestiona la pasarela de mensajería (Telegram, Discord, etc.).
hermes proxy	Proxy local compatible con OpenAI que reutiliza tus credenciales OAuth.
hermes egress	Firewall de credenciales para sandboxes remotos (evita exponer claves reales).
hermes lsp	Integra Language Servers (pyright, gopls…) para diagnósticos al editar código.
hermes setup	Asistente de configuración inicial (modelo, terminal, gateway, tools, agente).
hermes whatsapp / hermes whatsapp-cloud	Configura el puente de WhatsApp (personal o Business API).
hermes slack	Genera el manifiesto de la app de Slack con todos los [[cheat-sheet-comandos-github-cloudflare-audio-imagen
hermes auth	Gestiona credenciales/API keys, pools de claves y OAuth.
hermes send	Envía un mensaje puntual a una plataforma configurada, sin levantar el agente.
hermes peer	Registra otras instancias de Hermes como “peers” para chats bot-a-bot entre máquinas.
hermes secrets	Trae API keys desde un gestor externo (Bitwarden Secrets Manager).
hermes migrate	Reescribe config.yaml para reemplazar modelos/ajustes obsoletos.
hermes status	Muestra estado del agente, auth y plataformas conectadas.
hermes cron	Lista y gestiona tareas programadas.
hermes kanban	Tablero Kanban multi-perfil para coordinar tareas entre agentes.
hermes project	Gestiona “proyectos” (workspaces con varias carpetas/repos).
hermes webhook	Crea suscripciones a webhooks que activan al agente por eventos externos.
hermes hooks	Inspecciona/aprueba hooks de shell declarados en la config.
hermes doctor	Diagnostica problemas de configuración/dependencias (con --fix).
hermes security audit	Auditoría de vulnerabilidades (OSV.dev) del entorno, plugins y servidores MCP.
hermes approvals	Analiza tu historial de aprobaciones para sugerir una lista blanca.
hermes dump	Resumen copiable del setup completo, útil para pedir soporte.
hermes prompt-size	Desglosa cuánto presupuesto de prompt ocupan skills, memoria y tools.
hermes debug	Sube logs/información del sistema para soporte.
hermes backup / hermes import	Crea o restaura una copia de seguridad del directorio Hermes.
hermes checkpoints	Inspecciona/limpia el almacén de checkpoints que usa /rollback.
hermes logs	Ver, filtrar y seguir en vivo los logs (agente, gateway, errores).
hermes config	Ver/editar/consultar la configuración (get, set, unset, edit).
hermes skin	Cambia el tema visual de la CLI.
hermes pairing	Aprueba o revoca códigos de emparejamiento de usuarios en mensajería.
hermes skills	Busca, instala, inspecciona y audita skills desde registros online.
hermes bundles	Agrupa varias skills bajo un único comando /nombre.
hermes curator	Mantenimiento automático de skills en segundo plano.
hermes journey	Línea de tiempo de skills y memorias aprendidas.
hermes memory	Configura proveedores de memoria externos (Honcho, Mem0, etc.).
hermes acp	Corre Hermes como servidor ACP para integrarlo en editores (VS Code, Zed…).
hermes mcp	Gestiona servidores MCP (Model Context Protocol).
hermes plugins	Instala/activa/desactiva plugins de Hermes.
hermes portal	Estado de la cuenta Nous Portal y el Tool Gateway (búsqueda web, TTS, imágenes…).
hermes tools	Activa/desactiva herramientas por plataforma.
hermes computer-use	Instala el backend para que el agente controle el escritorio (mouse/teclado).
hermes pets	Mascotas animadas (“petdex”) que decoran la CLI/TUI/desktop.
hermes sessions	Explora, exporta y borra sesiones guardadas.
hermes insights	Analítica de tokens, coste y actividad.
hermes claw	Migración desde OpenClaw.
hermes import-agent	Importa configuración desde Claude Code o Codex CLI.
hermes dashboard	Lanza el panel web para gestionar config, claves y sesiones.
hermes serve	Backend headless (usado por la app de escritorio).
hermes desktop (alias gui)	Lanza la app de escritorio (Electron).
hermes profile	Gestiona perfiles: varias instancias aisladas de Hermes.
hermes completion	Imprime scripts de autocompletado (bash/zsh/fish).
hermes update	Actualiza Hermes a la última versión.
hermes uninstall	Desinstala Hermes.

Opciones globales útiles (van antes del comando): --profile, --resume/-c (continuar sesión), --worktree (git worktree aislado), --yolo (saltar confirmaciones peligrosas), --tui (interfaz de terminal completa), --ignore-rules (ignorar AGENTS.md/SOUL.md/memoria).

---

2. Comandos slash (dentro del chat, /comando)

Sesión

Comando	Qué hace
/new /reset	Nueva sesión (borra historial en memoria).
/clear	Limpia pantalla y empieza sesión nueva.
/history	Muestra el historial de la conversación.
/save	Guarda la conversación actual.
/prompt /compose	Redacta el próximo prompt en tu editor externo ($EDITOR).
/retry	Reenvía el último mensaje.
/undo	Elimina el último intercambio usuario/agente.
/title	Pone título a la sesión.
/compress	Comprime manualmente el contexto (resume y libera memoria).
/rollback	Lista o restaura checkpoints de archivos.
/diff	Muestra los cambios git hechos en el directorio de trabajo.
/snapshot /snap	Crea/restaura instantáneas del estado completo de Hermes.
/stop	Mata todos los procesos en segundo plano.
/queue /q	Encola un prompt para el siguiente turno sin interrumpir.
/steer	Inyecta una nota a mitad de tarea (llega tras la próxima llamada a herramienta).
/goal	Fija un objetivo persistente: el agente sigue trabajando turno tras turno hasta cumplirlo.
/subgoal	Añade un criterio extra al objetivo activo.
/heartbeat /hb	Prompt recurrente que se reactiva cuando la sesión está inactiva.
/loop /proactive	Repite un prompt en un intervalo fijo dentro de la sesión.
/refine	Lanza ya mismo la revisión de auto-mejora de memoria/skills.
/review	Lanza un subagente independiente para revisar el trabajo (PR, código, docs).
/moa	Ejecuta un prompt puntual con el preset de “Mixture of Agents”.
/resume	Retoma una sesión guardada por nombre.
/sessions /switch	Explora y cambia entre sesiones.
/egress	Estado del proxy de egress (credenciales para sandboxes).
/redraw	Repinta la interfaz (arregla artefactos visuales del terminal).
/status	Info de la sesión: modelo, proveedor, tokens, resumen de actividad reciente.
/context /ctx	Desglose visual del uso de la ventana de contexto.
/agents /tasks	Muestra agentes activos y tareas en curso.
/bg	Ejecuta un prompt en una sesión de fondo aparte.
/btw	Pregunta lateral sobre la conversación actual sin interrumpirla.
/branch /fork	Bifurca la sesión para explorar un camino distinto.
/worktree	Crea/inspecciona git worktrees aislados a mitad de sesión.
/handoff	Traspasa la sesión actual a una plataforma de mensajería.
/journey /learning	Línea de tiempo de aprendizaje (skills + memorias).

Configuración

Comando	Qué hace
/config	Muestra la configuración actual.
/model	Cambia de modelo/proveedor ya configurados.
/personality	Aplica una personalidad predefinida al agente.
/verbose	Cicla el nivel de detalle mostrado sobre las herramientas usadas.
/focus	Modo de vista reducida: solo tu prompt y la respuesta final.
/fast	Activa el modo de procesamiento prioritario/rápido.
/reasoning	Ajusta el nivel de razonamiento del modelo.
/skin	Cambia el tema visual.
/export / /import	Empaqueta o instala un perfil completo compartible.
/statusbar /sb	Muestra/oculta la barra de estado.
/battery	Indicador de batería en la barra de estado.
/voice	Modo de voz (grabación y respuesta hablada).
/yolo	Activa/desactiva saltar confirmaciones de comandos peligrosos.
/approvals	Modo de aprobación de comandos (manual/inteligente/apagado).
/busy	Define qué pasa si le escribes mientras trabaja (encolar/dirigir/interrumpir).
/timestamps	Muestra hora en cada mensaje.
/wake	Activa el detector de palabra de activación (“Hey Hermes”).

Herramientas y skills

Comando	Qué hace
/tools	Lista o activa/desactiva herramientas para la sesión.
/toolsets	Lista los conjuntos de herramientas disponibles.
/browser	Conecta el agente a un navegador Chrome/Brave/Edge vía CDP.
/skills	Busca, instala, inspecciona y gestiona skills desde registros online.
/memory	Revisa y aprueba/rechaza escrituras de memoria pendientes.
/bundles	Lista los “bundles” (grupos de skills bajo un solo comando).
/learn	Convierte cualquier cosa (carpeta, URL, conversación) en una skill reutilizable.
/plan	Escribe un plan de implementación en markdown, sin ejecutar nada.
/init	Genera o actualiza AGENTS.md a partir de un escaneo del repo.
/cron	Gestiona tareas programadas (crear, pausar, editar).
/suggestions /suggest	Revisa automatizaciones sugeridas por el propio agente.
/blueprint /bp	Crea una automatización a partir de una plantilla.
/curator	Controla el mantenimiento automático de skills.
/kanban	Maneja el tablero Kanban sin salir del chat.
/reload-mcp	Recarga servidores MCP sin reiniciar la sesión.
/reload-skills	Vuelve a escanear la carpeta de skills instaladas.
/reload	Recarga variables de entorno (.env) sin reiniciar.
/plugins	Lista los plugins instalados.
/pet /hatch	Gestiona o genera mascotas animadas.

Información

Comando	Qué hace
/help	Lista de comandos disponibles, agrupados por categoría.
/palette	Paleta de comandos con búsqueda difusa (Ctrl+P).
/version	Versión y entorno de Hermes.
/whoami	Tu nivel de acceso (admin/usuario).
/usage	Consumo de tokens, coste y límites de cuenta.
/topup	Saldo de Nous y gestión de facturación.
/insights	Analítica de uso de los últimos 30 días.
/update	Actualiza Hermes.
/platforms /gateway	Estado de las plataformas de mensajería conectadas.
/paste / /image	Adjunta una imagen (portapapeles o archivo).
/copy	Copia la última respuesta al portapapeles.
/debug	Sube un reporte de depuración para soporte.
/profile	Nombre y ruta del perfil activo.
/quit /exit	Sale de la CLI.

[!tip] Comandos dinámicos Cualquier skill instalada se convierte automáticamente en un comando /nombre-skill (ej. /gif-search, /github). Escribe / para ver el autocompletado.

---

3. Skills y funciones más interesantes

Skills incorporadas (bundled) más útiles

Skill	Para qué sirve
hermes-agent	Meta-skill: usar, configurar, tematizar y orquestar el propio Hermes.
claude-code / codex / opencode	Delegar tareas de programación a otros CLIs de IA (features, PRs).
github	Gestionar PRs, issues y repos vía gh CLI.
obsidian	Leer, buscar, crear y editar notas directamente en tu bóveda de Obsidian.
google-workspace	Gmail, Calendar, Drive, Docs y Sheets desde un solo CLI.
notion	Páginas y bases de datos de Notion en markdown.
email-inbox-triage	Prioriza tu bandeja y redacta respuestas de forma segura.
meeting-action-items / document-to-action-items	Extrae tareas y decisiones citadas de reuniones o documentos.
pdf / docx / xlsx / powerpoint	Crear y editar archivos de Office/PDF sin abrir ninguna app.
systematic-debugging	Depuración en 4 fases: entender el bug antes de tocar el código.
test-driven-development	Fuerza el ciclo RED-GREEN-REFACTOR (tests antes que código).
requesting-code-review	Revisión pre-commit: seguridad, calidad y auto-arreglos.
arxiv / grounded-citations	Investigación con papers y respuestas ancladas a fuentes verificables.
weekly-review-planning	Repaso semanal: compromisos, trabajo estancado, plan de la semana.
blocked-page-recovery	Recupera contenido cuando una web bloquea el scraping (403/429/paywall).

Funciones (no son “skills” técnicamente, pero son las más potentes)

• Memoria persistente (MEMORY.md/USER.md) — recuerda tus preferencias entre sesiones.
• Delegación en subagentes (delegate_task) — hasta 3 subagentes en paralelo con su propio contexto y terminal.
• Kanban multi-perfil — tablero de tareas para coordinar varios agentes trabajando a la vez.
• Goals y Loops (/goal, /loop) — el agente sigue trabajando turno tras turno hasta cumplir un objetivo.
• Checkpoints y /rollback — red de seguridad: deshace cambios de archivos si algo sale mal.
• Tool Gateway (Nous Portal) — búsqueda web, generación de imágenes, TTS y navegador, todo en un solo login.
• MCP — conecta cualquier servidor MCP (bases de datos, APIs internas) sin escribir código.
• /learn — convierte cualquier flujo de trabajo que le enseñes en una skill reutilizable, sin escribir el SKILL.md a mano.
• Cron con blueprints — automatizaciones programadas con plantillas listas para usar.
• Credential Pools — rota entre varias API keys del mismo proveedor automáticamente.

---

4. Consejos y trucos útiles

Rendimiento y coste

• Usa hermes -z "prompt" para scripts/cron: solo imprime el texto final, sin ruido — ideal para capturar la respuesta con $(...).
• Cambiar de modelo a mitad de conversación (/model) resetea la caché de prompt: el siguiente turno se cobra a precio completo. Evítalo en sesiones largas si puedes.
• hermes prompt-size te dice qué está inflando tu prompt (skills, memoria, tools). Si vas sobrado de contexto, desinstala skills que no uses (hermes skills uninstall) o desactiva toolsets (hermes tools).
• --usage-file en hermes -z genera un JSON con coste estimado y tokens — útil para pipelines que necesitan controlar gasto.

Seguridad

• --yolo salta las confirmaciones de comandos peligrosos: cómodo, pero úsalo con cuidado (mejor en entornos aislados/sandboxes).
• hermes egress evita que un sandbox remoto tenga tus claves reales: intercepta el tráfico y las inyecta solo en el borde de red.
• hermes security audit revisa vulnerabilidades en tu entorno, plugins y servidores MCP contra OSV.dev.
• Activa skills.write_approval y memory.write_approval para revisar manualmente lo que el agente quiere guardar como skill o memoria antes de que se escriba.

Productividad diaria

• /plan escribe un plan en markdown sin tocar nada — perfecto para revisar el enfoque antes de dejar que el agente actúe.
• /init genera un AGENTS.md a partir de escanear tu repo, para que futuras sesiones ya entiendan el proyecto.
• /goal + /subgoal sirven para tareas largas: defines el objetivo y el agente sigue iterando solo hasta cumplirlo (con límite de turnos configurable).
• /bg lanza trabajo en segundo plano sin bloquear tu sesión actual; /btw hace una pregunta lateral sin interrumpir el turno en curso.
• Usa /worktree o hermes chat --worktree para trabajar en una rama git aislada cuando corras varios agentes en paralelo sobre el mismo repo.

Recuperación ante errores

• Todo cambio de archivos queda respaldado por checkpoints automáticos: /rollback deshace la última tanda de cambios si algo sale mal.
• /snapshot create guarda una foto completa del estado de Hermes (config + sesiones); /snapshot restore <id> la recupera.
• hermes doctor --fix diagnostica y repara automáticamente problemas comunes de configuración.
• hermes dump genera un resumen copiable de tu setup — pégalo tal cual al pedir ayuda en Discord o GitHub Issues.

Multi-agente y automatización

• hermes kanban te deja coordinar varios agentes trabajando sobre distintas tareas del mismo proyecto, con dependencias entre tareas (link) y revisión (request-review).
• hermes cron create programa tareas con lenguaje natural o expresión cron, y puede adjuntarles skills específicas.
• hermes peer permite que agentes en máquinas distintas se manden mensajes entre sí (bot-a-bot).
• hermes send es la forma más barata de mandar una notificación puntual a Telegram/Discord/Slack: no gasta ni una llamada al modelo.

Personalización

• SOUL.md es lo primero que lee el modelo en cada sesión: úsalo para fijar la personalidad/identidad del agente de forma permanente.
• Los skill bundles (/bundles) agrupan varias skills bajo un único comando /nombre — útil si sueles usar el mismo combo cada vez.
• Los quick commands en config.yaml te dejan crear atajos tipo /deploy que ejecutan un script de shell o un alias a otro comando.

---

Fuentes

• Documentación oficial: hermes-agent.nousresearch.com/docs
• Referencia de comandos CLI y slash commands
• Catálogo de skills incorporadas (skills-catalog)