hermes profile Befehl — Vollständige Referenz & Beispiele

Überblick

hermes profile verwaltet mehrere isolierte Hermes-Instanzen. Jedes Profil hat eigene Konfiguration, Sessions, Skills, Memory und Anmeldedaten und liegt unter ~/.hermes/profiles/<name>/. Das Profil default existiert immer.

Mit dem globalen Flag --profile <name> (oder -p) kann ein einzelner Befehl gegen ein anderes Profil ausgeführt werden, ohne den Standard zu ändern.

hermes profile <Unterbefehl>

Unterbefehle

list

Alle Profile auflisten.

hermes profile list

use <Name>

Das Standardprofil festlegen.

hermes profile use work

create <Name>

Ein neues Profil erstellen. Profilnamen sollten klein geschrieben und alphanumerisch sein.

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

Flags:

• --clone — config.yaml, .env, SOUL.md und Skills aus dem aktiven Profil kopieren.
• --clone-all — Vollständige Kopie des aktiven Profils (außer dem profilspezifischen Verlauf).
• --clone-from SOURCE — Von einem bestimmten Quellprofil kopieren (impliziert --clone, außer --clone-all ist gesetzt).
• --no-alias — Kein Wrapper-Skript erstellen.
• --no-skills — Leeres Profil ohne mitgelieferte Skills erstellen.
• --description — Ein- bis zweisätzige Beschreibung, die vom Kanban-Decomposer verwendet wird.

delete <Name>

Ein Profil und alle seine Daten löschen.

hermes profile delete old-project [-y]

describe [Name]

Die Beschreibung eines Profils lesen oder setzen.

hermes profile describe work --text "Backend-Arbeitsprofil"
hermes profile describe --auto --all

Flags:

• --text TEXT — Beschreibung auf genau diesen Text setzen.
• --auto — Beschreibung automatisch über das Hilfs-LLM generieren.
• --overwrite — Mit --auto auch bestehende Beschreibungen ersetzen.
• --all — Mit --auto für jedes Profil ohne Beschreibung ausführen.

show <Name>

Profildetails anzeigen.

hermes profile show work

alias <profile_name>

Wrapper-Skripte für ein Profil verwalten.

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

rename <alt> <neu>

Ein Profil umbenennen.

hermes profile rename work company-x

export <Name>

Ein Profil in ein .tar.gz-Archiv exportieren.

hermes profile export work -o work.tar.gz

import <Archiv>

Ein Profil aus einem .tar.gz-Archiv importieren.

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

install <Quelle>

Eine Hermes-Profil-Distribution von einer Git-URL (z. B. github.com/user/repo, https://..., git@...) oder einem lokalen Verzeichnis mit distribution.yaml im Wurzelverzeichnis installieren.

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

Flags:

• --name NAME — Profilnamen aus dem Manifest überschreiben.
• --alias — Einen Shell-Wrapper-Alias erstellen.
• --force — Ein bestehendes Profil gleichen Namens überschreiben (Nutzerdaten bleiben erhalten).
• -y — Bestätigung der Manifestvorschau überspringen.

update <Name>

Die Distribution aus ihrer gespeicherten Quelle neu abrufen und Updates anwenden. Nutzerdaten (Memories, Sessions, Auth, .env) bleiben erhalten; config.yaml wird ebenfalls beibehalten, außer bei --force-config.

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

info <Name>

Das Distributionsmanifest eines Profils anzeigen (Version, Anforderungen, Quelle).

hermes profile info work

Häufige Szenarien

# Arbeitsprofil erstellen und aktivieren
hermes profile create work --description "Backend-Arbeit"
hermes profile use work

# Einmaliger Befehl in einem anderen Profil ohne Umstellung
hermes --profile personal chat -q "Plane mein Wochenende"

# Profil exportieren und später wieder importieren
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name work-restored

# Geteiltes Team-Profil installieren
hermes profile install [email protected]:org/team-hermes-profile --alias -y

# Distributionsbasiertes Profil aktualisieren
hermes profile update team-profile -y

Tipps

• Profile sind vollständig isoliert: Konfiguration, Sessions, Anmeldedaten und Memory vermischen sich nicht.
• Verwende hermes --profile <Name> ... für einmalige Aufrufe, ohne den Standard zu ändern.
• describe --auto --all ist vor der Nutzung von Kanban hilfreich, da der Decomposer Beschreibungen zum Routen von Aufgaben verwendet.
• Distributionsinstallationen (install/update) erhalten Nutzerdaten und überschreiben standardmäßig nur distributions-eigene Dateien.