Comando hermes migrate — Referencia Completa y Ejemplos

Descripción General

hermes migrate ayuda a mantener tu archivo config.yaml actualizado. Diagnostica configuraciones que hacen referencia a modelos retirados o ajustes obsoletos y, opcionalmente, los reescribe con los equivalentes modernos.

hermes migrate [provider]

Esto es especialmente útil después de actualizar Hermes, cuando los proveedores han cambiado sus modelos disponibles.

Escenarios Comunes

Diagnóstico General

# Revisar toda la configuración
hermes migrate

# Salida típica:
# Checking ~/.hermes/config.yaml...
# ⚠ openrouter: model 'claude-3-opus' is retired → suggest 'claude-opus-4-20250514'
# ⚠ xai: model 'grok-2' is deprecated → suggest 'grok-3'
# ✓ anthropic: up to date
# Run 'hermes migrate --apply' to fix automatically.

Migrar un Proveedor Específico

# Solo revisar la configuración de xai
hermes migrate xai

Aplicar Cambios Automáticamente

# Migrar y aplicar cambios
hermes migrate --apply

# O revisar primero y luego aplicar
hermes migrate
hermes migrate --apply

Después de Actualizar Hermes

# Flujo típico post-actualización
hermes update --backup
hermes migrate                # Revisar cambios necesarios
hermes migrate --apply        # Aplicar migraciones
hermes doctor                 # Verificar que todo funciona

Consejos

Ejecuta hermes migrate después de cada hermes update para mantener la configuración al día
Siempre revisa los cambios sugeridos antes de aplicar con --apply
Si tienes configuraciones personalizadas complejas, haz backup primero: hermes backup
Puedes ejecutarlo en modo solo-diagnóstico sin --apply para ver qué cambiaría sin modificar nada
Es seguro ejecutarlo múltiples veces — no duplica ni corrompe la configuración