===============================================================
  GUÍA RÁPIDA DE HERMES — comandos y atajos
  Curso "De 0 a 100 con IA" · ia con lala
===============================================================

  Guárdate este archivo. Es lo que vas a abrir cada vez que se te
  olvide un comando — que va a ser seguido, y está bien.


---------------------------------------------------------------
1 · EL ATAJO — haz esto PRIMERO
---------------------------------------------------------------

El comando completo de Hermes en Docker es insoportable de escribir:

   docker run -it --rm -v ~/hermes-docker:/opt/data nousresearch/hermes-agent

Le ponemos un apodo: "herk". Pega esto en la terminal:

   alias herk='docker run -it --rm -v ~/hermes-docker:/opt/data nousresearch/hermes-agent'

⚠️ OJO — ese atajo SE BORRA cuando cierres la terminal.
Para que quede para siempre, pega estos dos comandos:

   echo "alias herk='docker run -it --rm -v ~/hermes-docker:/opt/data nousresearch/hermes-agent'" >> ~/.zshrc
   source ~/.zshrc

(Si tu Mac es viejito y usa bash, cambia .zshrc por .bashrc)

Compruébalo: cierra la terminal, ábrela de nuevo y escribe:

   herk version

Si te responde, quedó. Desde ahora "herk" reemplaza todo ese comando.


---------------------------------------------------------------
2 · COMANDOS DE LA TERMINAL
---------------------------------------------------------------

PARA ARRANCAR
   herk setup              Configurarlo (modelo, claves, Telegram)
   herk setup --portal     Configurarlo con Nous Portal (un solo registro)
   herk                    Abrir el chat ahí mismo en la terminal
   herk version            Ver qué versión tienes

PARA DEJARLO PRENDIDO
   docker run -d --name hermes-demo --restart unless-stopped \
     -v ~/hermes-docker:/opt/data -p 8643:8642 \
     nousresearch/hermes-agent gateway run

   (Ese es el largo. Solo se usa la primera vez.)

PARA MANEJARLO DÍA A DÍA
   docker ps                    ¿Está corriendo?
   docker logs hermes-demo      ¿Qué está diciendo? (cuando algo falla)
   docker stop hermes-demo      Apagarlo
   docker start hermes-demo     Volverlo a prender
   docker restart hermes-demo   Apagar y prender de una

PARA ACTUALIZARLO
   docker pull nousresearch/hermes-agent:latest
   docker rm -f hermes-demo
   docker run -d --name hermes-demo --restart unless-stopped \
     -v ~/hermes-docker:/opt/data -p 8643:8642 \
     nousresearch/hermes-agent gateway run

   Tus datos NO se pierden: viven en ~/hermes-docker, no en la cajita.

PARA BORRARLO SIN DEJAR RASTRO
   docker rm -f hermes-demo     Bota la cajita
   rm -rf ~/hermes-docker       Borra su cerebro (¡esto sí borra de verdad!)


---------------------------------------------------------------
3 · COMANDOS DEL CHAT (los que escribes ADENTRO)
---------------------------------------------------------------

EL ÚNICO QUE HAY QUE MEMORIZAR
   /help          La lista completa de TU versión. Siempre actualizada.

LOS DEL DÍA A DÍA
   /new           Empezar conversación nueva
   /reset         Igual que /new — limpia todo
   /compress      Resumir lo hablado (ahorra plata)
   /model         Cambiar el cerebro sin salir
   /usage         Cuánto has gastado
   /undo          Deshacer el último turno
   /retry         Que lo intente otra vez

LOS QUE VALEN LA PENA
   /goal          Ponle una meta y trabaja hasta lograrla
   /skills        Ver y manejar lo que le has enseñado
   /personality   Cambiarle el tono sin tocar el soul.md
   /reasoning     Qué tanto quieres que piense antes de responder
   /kanban        El tablero de tareas (con varios agentes)
   /voice         Modo voz: hablarle en vez de escribirle
   /moa           Respuesta con varios modelos a la vez

EXTRA
   herk claw migrate    Traerte tus cosas si venías de OpenClaw


---------------------------------------------------------------
4 · CUANDO ALGO FALLA
---------------------------------------------------------------

"Cannot connect to the Docker daemon"
   → Docker no está abierto. Ábrelo, espera la ballenita 🐳 y repite.

"herk: command not found"
   → El atajo se borró (cerraste la terminal) o no lo dejaste fijo.
     Vuelve al punto 1.

Te pide iniciar sesión y no hay navegador
   → Normal: la cajita no tiene navegador. Pega una clave de API,
     o copia el enlace que te muestra y ábrelo en tu navegador.

El bot de Telegram no contesta
   → Mira si está corriendo:  docker ps
     Si no aparece:           docker start hermes-demo
     Si aparece pero calla:   docker logs hermes-demo

Cualquier otra cosa
   → Copia el error y pégaselo a Claude Code diciéndole que no eres
     programador y que te lo explique en español sencillo.


===============================================================
  guía rápida v1 · De 0 a 100 con IA · ia con lala
===============================================================