Comando hermes profile — Referencia Completa y Ejemplos

Descripción General

hermes profile gestiona múltiples instancias aisladas de Hermes. Cada perfil tiene su propia configuración, sesiones, skills, memoria y credenciales, y se almacena en ~/.hermes/profiles/<nombre>/. El perfil default siempre existe.

Usa el flag global --profile <nombre> (o -p) para ejecutar un comando en otro perfil sin cambiar el predeterminado.

hermes profile <subcomando>

Subcomandos

list

Ver todos los perfiles.

hermes profile list

use <nombre>

Establecer el perfil predeterminado.

hermes profile use work

create <nombre>

Crear un perfil nuevo. El nombre debe ser alfanumérico y en minúsculas.

hermes profile create work [--clone] [--clone-all] [--clone-from SOURCE] [--no-alias] [--no-skills] [--description "Trabajo backend"]

Flags:

• --clone — Copiar config.yaml, .env, SOUL.md y skills del perfil activo.
• --clone-all — Copia completa del perfil activo (excepto el historial propio del perfil).
• --clone-from SOURCE — Copiar de un perfil origen específico (implica --clone salvo que uses --clone-all).
• --no-alias — No crear el script wrapper.
• --no-skills — Crear un perfil vacío sin skills empaquetadas.
• --description — Descripción de una o dos frases, usada por el descomponedor de kanban.

delete <nombre>

Eliminar un perfil y todos sus datos.

hermes profile delete old-project [-y]

describe [nombre]

Leer o establecer la descripción de un perfil.

hermes profile describe work --text "Perfil de trabajo backend"
hermes profile describe --auto --all

Flags:

• --text TEXT — Fijar la descripción exacta.
• --auto — Generar la descripción automáticamente con el LLM auxiliar.
• --overwrite — Con --auto, reemplazar descripciones existentes también.
• --all — Con --auto, generar descripciones para todos los perfiles que la falten.

show <nombre>

Mostrar detalles de un perfil.

hermes profile show work

alias <profile_name>

Gestionar scripts wrapper para un perfil.

hermes profile alias work [--name work-hermes]
hermes profile alias work --remove

rename <viejo> <nuevo>

Renombrar un perfil.

hermes profile rename work company-x

export <nombre>

Exportar un perfil a un archivo .tar.gz.

hermes profile export work -o work.tar.gz

import <archivo>

Importar un perfil desde un archivo .tar.gz.

hermes profile import work.tar.gz [--name work]

install <origen>

Instalar una distribución de perfil de Hermes desde una URL de git (por ejemplo github.com/usuario/repo, https://..., git@...) o un directorio local que contenga distribution.yaml en su raíz.

hermes profile install https://github.com/org/profile-dist [--name work] [--alias] [--force] [-y]

Flags:

• --name NAME — Sobrescribir el nombre del perfil del manifiesto.
• --alias — Crear un alias wrapper en shell.
• --force — Sobrescribir un perfil existente con el mismo nombre (se preservan los datos del usuario).
• -y — Saltar la confirmación de vista previa del manifiesto.

update <nombre>

Volver a descargar la distribución desde su origen registrado y aplicar actualizaciones. Los datos del usuario (memorias, sesiones, auth, .env) se preservan; config.yaml también se conserva salvo que uses --force-config.

hermes profile update work [--force-config] [-y]

info <nombre>

Mostrar el manifiesto de la distribución de un perfil (versión, requisitos, origen).

hermes profile info work

Ejemplos

# Crear y cambiar al perfil de trabajo
hermes profile create work --description "Trabajo backend"
hermes profile use work

# Ejecutar un comando puntual en otro perfil sin cambiar el predeterminado
hermes --profile personal chat -q "Planifica mi fin de semana"

# Exportar y luego reimportar un perfil
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name work-restored

# Instalar una distribución de perfil compartida por el equipo
hermes profile install [email protected]:org/team-hermes-profile --alias -y

# Actualizar un perfil respaldado por distribución
hermes profile update team-profile -y

Consejos

• Los perfiles son completamente aislados: configuraciones, sesiones, credenciales y memoria no se mezclan.
• Usa hermes --profile <nombre> ... para comandos puntuales sin cambiar el perfil predeterminado.
• describe --auto --all es útil antes de usar kanban, porque el descomponedor usa las descripciones para enrutar tareas.
• Las instalaciones de distribución (install/update) preservan los datos del usuario y solo sobrescriben archivos propios de la distribución por defecto.