Commande hermes profile — Référence Complète & Exemples

Vue d’ensemble

hermes profile gère plusieurs instances Hermes isolées. Chaque profil possède sa propre configuration, ses sessions, ses skills, sa mémoire et ses identifiants, et est stocké sous ~/.hermes/profiles/<nom>/. Le profil default existe toujours.

Utilisez le flag global --profile <nom> (ou -p) pour exécuter une commande sur un autre profil sans changer le profil par défaut.

hermes profile <sous-commande>

Sous-commandes

list

Lister tous les profils.

hermes profile list

use <nom>

Définir le profil par défaut.

hermes profile use work

create <nom>

Créer un nouveau profil. Le nom doit être en minuscules et alphanumérique.

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

Flags:

• --clone — Copier config.yaml, .env, SOUL.md et les skills du profil actif.
• --clone-all — Copie complète du profil actif (sauf l’historique propre au profil).
• --clone-from SOURCE — Copier depuis un profil source spécifique (implique --clone sauf si --clone-all est utilisé).
• --no-alias — Ne pas créer le script wrapper.
• --no-skills — Créer un profil vide sans skills fournies.
• --description — Description d’une ou deux phrases utilisée par le décomposeur kanban.

delete <nom>

Supprimer un profil et toutes ses données.

hermes profile delete old-project [-y]

describe [nom]

Lire ou définir la description d’un profil.

hermes profile describe work --text "Profil de travail backend"
hermes profile describe --auto --all

Flags:

• --text TEXT — Définir la description exacte.
• --auto — Générer la description automatiquement via le LLM auxiliaire.
• --overwrite — Avec --auto, remplacer aussi les descriptions existantes.
• --all — Avec --auto, traiter chaque profil sans description.

show <nom>

Afficher les détails d’un profil.

hermes profile show work

alias <profile_name>

Gérer les scripts wrapper d’un profil.

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

rename <ancien> <nouveau>

Renommer un profil.

hermes profile rename work company-x

export <nom>

Exporter un profil vers une archive .tar.gz.

hermes profile export work -o work.tar.gz

import <archive>

Importer un profil depuis une archive .tar.gz.

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

install <source>

Installer une distribution de profil Hermes depuis une URL git (par exemple github.com/user/repo, https://..., git@...) ou un répertoire local contenant distribution.yaml à sa racine.

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

Flags:

• --name NAME — Remplacer le nom du profil défini dans le manifeste.
• --alias — Créer un alias wrapper shell.
• --force — Écraser un profil existant de même nom (les données utilisateur sont préservées).
• -y — Sauter la confirmation d’aperçu du manifeste.

update <nom>

Ré-extraire la distribution depuis sa source enregistrée et appliquer les mises à jour. Les données utilisateur (mémoires, sessions, auth, .env) sont préservées ; config.yaml l’est aussi, sauf si --force-config est passé.

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

info <nom>

Afficher le manifeste de distribution d’un profil (version, prérequis, source).

hermes profile info work

Exemples

# Créer et passer au profil de travail
hermes profile create work --description "Travail backend"
hermes profile use work

# Commande ponctuelle dans un autre profil sans changer le défaut
hermes --profile personal chat -q "Planifie mon week-end"

# Exporter puis réimporter un profil
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name work-restored

# Installer une distribution de profil partagée par l'équipe
hermes profile install [email protected]:org/team-hermes-profile --alias -y

# Mettre à jour un profil basé sur une distribution
hermes profile update team-profile -y

Astuces

• Les profils sont complètement isolés : configuration, sessions, identifiants et mémoire ne se mélangent pas.
• Utilisez hermes --profile <nom> ... pour des appels ponctuels sans modifier le profil par défaut.
• describe --auto --all est utile avant d’utiliser kanban, car le décomposeur se sert des descriptions pour router les tâches.
• Les installations de distribution (install/update) préservent les données utilisateur et ne remplacent par défaut que les fichiers appartenant à la distribution.