hmgr 0.0.3 → 0.0.5

package/dist/adapter/skill-md.js

@@ -1,4 +1,4 @@
-// Name eines Skills: `name` aus dem Frontmatter der SKILL.md, sonst der Verzeichnisname (E32).
+// Name, Beschreibung und Besonderheiten eines Skills aus dem Frontmatter der SKILL.md (E32, E39, E55).
 import { parse } from 'yaml';
 export const SKILL_DATEI = 'SKILL.md';
 /** Der Block zwischen der ersten Zeile `---` und der nächsten Zeile `---`. Fehlt er, undefined. */
@@ -12,38 +12,114 @@ function frontmatter(inhalt) {
     return undefined;
 }
 /**
- * Der Verzeichnisname ist nur Konvention, das Frontmatter ist die Aussage des Autors (E18, E32).
- * Ohne Frontmatter, ohne YAML-Objekt, bei kaputtem YAML oder ohne nicht leeren `name` gilt der
- * Verzeichnisname. Ein Name mit Pfadtrenner gilt nicht, aus ihm würde im Ziel kein Eintrag,
- * sondern ein Pfad.
+ * Das Frontmatter als Objekt, einmal geparst für alle Felder. Fehlt der Block, ist das YAML
+ * kaputt oder liest es sich nicht als Objekt, gibt es kein Ergebnis (E32).
  */
-export function skillName(verzeichnisname, skillMdInhalt) {
+function frontmatterDaten(skillMdInhalt) {
     if (skillMdInhalt === undefined)
-        return verzeichnisname;
+        return undefined;
     const block = frontmatter(skillMdInhalt);
     if (block === undefined)
-        return verzeichnisname;
+        return undefined;
     let daten;
     try {
         daten = parse(block);
     }
     catch {
-        return verzeichnisname;
+        return undefined;
     }
     if (typeof daten !== 'object' || daten === null || Array.isArray(daten))
-        return verzeichnisname;
-    const roh = daten['name'];
+        return undefined;
+    return daten;
+}
+/** Ein Textfeld, getrimmt, leer heißt „nicht vorhanden" (E39). */
+function textFeld(daten, feld) {
+    const roh = daten?.[feld];
     if (typeof roh !== 'string')
-        return verzeichnisname;
-    const name = roh.trim();
-    if (name.length === 0 || name === '.' || name === '..')
+        return undefined;
+    const wert = roh.trim();
+    return wert.length === 0 ? undefined : wert;
+}
+/** Ein boolesches Feld mit dem genannten erwarteten Wert, sonst „nicht vorhanden" (E55). */
+function boolFeld(daten, feld, erwartet) {
+    return daten?.[feld] === erwartet ? true : undefined;
+}
+/**
+ * Ein Feld, das vorhanden und nicht leer sein muss, unabhängig von seiner Art (E55: hooks,
+ * allowed-tools). Leere Liste, leeres Objekt, leerer Text und `false` heißen „nicht vorhanden":
+ * beides sind Arten zu sagen, dass es nichts gibt, und die Marke behauptete sonst etwas
+ * Sicherheitsrelevantes, das nicht dasteht.
+ */
+function vorhandenFeld(daten, feld) {
+    const roh = daten?.[feld];
+    if (roh === undefined || roh === null || roh === false)
+        return undefined;
+    if (typeof roh === 'string')
+        return roh.trim().length > 0 ? true : undefined;
+    if (Array.isArray(roh))
+        return roh.length > 0 ? true : undefined;
+    if (typeof roh === 'object')
+        return Object.keys(roh).length > 0 ? true : undefined;
+    return true;
+}
+/**
+ * Der Verzeichnisname ist nur Konvention, das Frontmatter ist die Aussage des Autors (E18, E32).
+ * Ohne Frontmatter, ohne YAML-Objekt, bei kaputtem YAML oder ohne nicht leeren `name` gilt der
+ * Verzeichnisname. Ein Name mit Pfadtrenner gilt nicht, aus ihm würde im Ziel kein Eintrag,
+ * sondern ein Pfad.
+ */
+function nameAus(daten, verzeichnisname) {
+    const name = textFeld(daten, 'name');
+    if (name === undefined || name === '.' || name === '..')
         return verzeichnisname;
     if (name.includes('/') || name.includes('\\'))
         return verzeichnisname;
     return name;
 }
-/** Skill aus seinem Pfad in der Quelle, Name nach `skillName`. */
-export function skillAusPfad(pfad, skillMdInhalt) {
-    const verzeichnisname = pfad.split('/').filter((t) => t.length > 0).at(-1) ?? pfad;
-    return { name: skillName(verzeichnisname, skillMdInhalt), pfad };
+/** Name eines Skills aus dem Frontmatter, sonst der Verzeichnisname (E32). */
+export function skillName(verzeichnisname, skillMdInhalt) {
+    return nameAus(frontmatterDaten(skillMdInhalt), verzeichnisname);
+}
+/**
+ * Beschreibung eines Skills aus dem Feld `description` im Frontmatter (E39), analog zur
+ * Namensregel E32: fehlendes Frontmatter, kein YAML-Objekt, kaputtes YAML oder kein nicht leerer
+ * Text ⇒ keine Beschreibung, nichts bricht ab.
+ */
+export function skillBeschreibung(skillMdInhalt) {
+    return textFeld(frontmatterDaten(skillMdInhalt), 'description');
+}
+/**
+ * Skill aus seinem Pfad in der Quelle: Name nach `skillName`, Beschreibung nach
+ * `skillBeschreibung`, Besonderheiten aus dem Frontmatter (E55), jedes Feld nur gesetzt, wenn
+ * etwas da ist. Das Frontmatter wird dafür einmal geparst, nicht je Feld: der Katalog einer Quelle
+ * geht über alle ihre Skills. `ersatzname` greift nur, wenn der Pfad kein Segment hergibt.
+ */
+export function skillAusPfad(pfad, skillMdInhalt, ersatzname) {
+    const verzeichnisname = pfad.split('/').filter((t) => t.length > 0).at(-1) ?? ersatzname ?? pfad;
+    const daten = frontmatterDaten(skillMdInhalt);
+    const skill = { name: nameAus(daten, verzeichnisname), pfad };
+    const beschreibung = textFeld(daten, 'description');
+    if (beschreibung !== undefined)
+        skill.beschreibung = beschreibung;
+    // `disable-model-invocation: true`: lädt erst bei `/name`. `user-invocable: false`: kein `/name`.
+    if (boolFeld(daten, 'disable-model-invocation', true))
+        skill.nurPerBefehl = true;
+    if (boolFeld(daten, 'user-invocable', false))
+        skill.nichtPerBefehl = true;
+    if (vorhandenFeld(daten, 'hooks'))
+        skill.registriertHooks = true;
+    if (vorhandenFeld(daten, 'allowed-tools'))
+        skill.werkzeugeErlaubt = true;
+    const kompatibilitaet = textFeld(daten, 'compatibility');
+    if (kompatibilitaet !== undefined)
+        skill.kompatibilitaet = kompatibilitaet;
+    const modell = textFeld(daten, 'model');
+    if (modell !== undefined)
+        skill.modell = modell;
+    if (textFeld(daten, 'context') === 'fork')
+        skill.eigenerKontext = true;
+    const argumentHinweis = textFeld(daten, 'argument-hint');
+    if (argumentHinweis !== undefined)
+        skill.argumentHinweis = argumentHinweis;
+    return skill;
 }

package/dist/adapter/terminal.js

@@ -14,11 +14,34 @@ export class TerminalRueckfrage {
             return false;
         const leser = createInterface({ input: process.stdin, output: process.stdout });
         try {
-            const antwort = await leser.question(`${frage} `);
+            const antwort = await leser.question(`${frage} [j/N] `);
             return JA.has(antwort.trim().toLowerCase());
         }
         finally {
             leser.close();
         }
     }
+    /**
+     * Nummerierte Liste, eine gelesene Zahl. Dieselbe Weiche wie bei `bestaetigen`: ohne Terminal auf
+     * beiden Seiten fragt hmgr nicht und gibt nichts aus. Alles, was keine der Nummern ist, auch die
+     * leere Eingabe, gilt als keine Antwort. Der Adapter rät nicht, er reicht das Nichts weiter.
+     */
+    async auswaehlen(frage, optionen) {
+        if (optionen.length === 0)
+            return undefined;
+        if (process.stdin.isTTY !== true || process.stdout.isTTY !== true)
+            return undefined;
+        const leser = createInterface({ input: process.stdin, output: process.stdout });
+        try {
+            const liste = optionen.map((option, i) => `  ${i + 1}) ${option}`).join('\n');
+            const antwort = await leser.question(`${frage}\n${liste}\nNummer [1-${optionen.length}]: `);
+            const nummer = Number(antwort.trim());
+            if (!Number.isInteger(nummer) || nummer < 1 || nummer > optionen.length)
+                return undefined;
+            return nummer - 1;
+        }
+        finally {
+            leser.close();
+        }
+    }
 }

package/dist/adapter/zustand-json.js

@@ -16,6 +16,10 @@ export class ZustandJson {
             quellen: (daten.quellen ?? []),
             arbeitsverzeichnisse: (daten.arbeitsverzeichnisse ?? []),
             bindungen: (daten.bindungen ?? []),
+            // Fehlt das Feld (state.json vor E38), gilt der bisherige Ist-Zustand: nur claude-code aktiv.
+            aktiveHarnesses: (daten.aktiveHarnesses ?? ['claude-code']),
+            // Fehlt das Feld (state.json vor E43), gilt: nichts ignoriert.
+            ignorierteEintraege: (daten.ignorierteEintraege ?? []),
         };
     }
     async schreiben(zustand) {

package/dist/cli/hilfe.js

@@ -9,23 +9,31 @@ geklontes Vorhaben holt seinen Stand mit hmgr sync.
 
 hmgr <kommando> [schalter]
 
-  source add <url|pfad>   Quelle hinzufügen (URL wird geklont, Pfad bleibt Arbeitskopie)
-  source list             Quellen zeigen
-  dir add <pfad>          Arbeitsverzeichnis merken und an seinen Zeiger binden
-  dir forget <pfad>       Arbeitsverzeichnis und Bindung vergessen, Links bleiben
-  dir list                Arbeitsverzeichnisse mit ihrer Bindung zeigen
-  link <skill>            Skill in ein Ziel verlinken
-  unlink <skill>          Link entfernen
-  adopt [name]            Fremde Links im Ziel durch eigene hmgr-Links ersetzen
-  plugin add <name>       Plugin in ein Ziel legen (installieren oder Skills verlinken)
-  plugin remove <name>    Plugin aus einem Ziel entfernen
-  plugin list             Plugins der Marketplaces aller Quellen
-  sync [pfad]             Ziel auf den Stand seines Zeigers bringen
-  update                  Alle Checkouts aktualisieren
-  status                  Ist-Zustand der Ziele
+  source add <url|pfad>     Quelle hinzufügen (URL wird geklont, Pfad bleibt Arbeitskopie)
+  source rename <url|pfad> <name>  Anzeigename der Quelle ändern
+  source remove <url|pfad>  Quelle vergessen, Checkouts und Links bleiben liegen
+  source list               Quellen zeigen
+  dir add <pfad>            Arbeitsverzeichnis merken und an seinen Zeiger binden
+  dir forget <pfad>         Arbeitsverzeichnis und Bindung vergessen, Links bleiben
+  dir list                  Arbeitsverzeichnisse mit ihrer Bindung zeigen
+  link <skill>              Skill in ein Ziel verlinken
+  unlink <skill>            Link entfernen
+  adopt [name]              Fremde Links im Ziel durch eigene hmgr-Links ersetzen
+  plugin add <name>         Plugin in ein Ziel legen (installieren oder Skills verlinken)
+  plugin remove <name>      Plugin aus einem Ziel entfernen
+  plugin list               Plugins der Marketplaces aller Quellen
+  sync [pfad]               Ziel auf den Stand seines Zeigers bringen
+  update                    Alle Checkouts aktualisieren
+  status                    Ist-Zustand der Ziele
+  harness list              Harness-Typen mit Stand aktiv/inaktiv und vorhanden
+  harness enable <name>     Harness-Typ aktivieren, hmgr richtet ihn künftig ein
+  harness disable <name>    Harness-Typ deaktivieren, mit Angebot zum Säubern
+  harness skills-dir <name> Verwalteten Skill-Ordner zeigen, festlegen oder entfernen
 
 hmgr help <kommando> zeigt Schalter, Beispiele und Zusammenhänge.`;
-const SOURCE = `hmgr source add <url|pfad>
+const SOURCE = `hmgr source add <url|pfad> [--name <name>]
+hmgr source rename <url|pfad> <name>
+hmgr source remove <url|pfad>
 hmgr source list
 
 Eine Quelle ist ein Git-Repo mit Skills. source add prüft, ob sie erreichbar ist, liest ihre Skills
@@ -33,18 +41,47 @@ und ihren Marketplace und merkt sie unter ~/.hmgr. Erst danach kennt hmgr die Sk
 denen link und plugin add arbeiten. Eine URL wird geklont, ein Pfad bleibt die Arbeitskopie, die
 dort schon liegt, und wird von hmgr nicht verändert.
 
-Schalter: keine.
+Welche Quelle gemeint ist, hängt an Host, Besitzer und Repo, nicht an der Schreibweise der URL. Ein
+Repo in SSH- und in HTTPS-Form ist dieselbe Quelle, mit und ohne .git-Suffix ebenso. Gefetcht wird
+unter der Schreibweise, die beim ersten source add stand. source remove trifft dieselbe Quelle auch
+in anderer Schreibweise (E36).
+
+Jede Quelle trägt einen Anzeigenamen (E59): ohne --name schlägt hmgr den Repo-Namen vor (letztes
+Pfadsegment, bei einer lokalen Quelle der Ordnername) und speichert ihn. Namen sind eindeutig, trägt
+eine andere geführte Quelle schon denselben, bricht source add ab. source rename ändert den Namen
+später; die Identität der Quelle bleibt dabei ihre URL bzw. ihr Pfad, nicht der Name. Bei einer schon
+bekannten Quelle (source add trifft sie erneut) bleibt ihr Name unverändert.
+
+source remove vergisst die Quelle nur aus dem Zustand (E54), wie dir forget das
+Arbeitsverzeichnis (E26): Checkouts und Links bleiben liegen, bestehende Links gelten danach als
+„Link ohne bekannte Quelle" und tauchen so in hmgr status auf, hmgr update prüft sie nicht mehr. Ein
+erneutes source add derselben Quelle macht sie wieder zu normalen Links.
+
+Danach bietet hmgr als eigene Rückfrage an, die Skills dieser Quelle komplett vom Rechner zu löschen
+(E58): alle ihre Links in allen Zielen und alle ihre Checkouts, alles oder nichts. Über die
+Harness-CLI installierte Plugins deinstalliert hmgr dabei nicht, sie werden nur genannt, ebenso
+Zeiger-Einträge (E57). Ohne Links und ohne Checkouts kommt die Rückfrage gar nicht erst. Ablehnen
+lässt alles liegen wie bisher.
+
+Schalter:
+  --name <name>   nur bei add: Anzeigename statt des abgeleiteten Vorschlags
 
 Beispiele:
   hmgr source add https://github.com/tim/skills.git
-  hmgr source add ~/.skills/tim-skills
+  hmgr source add ~/.skills/tim-skills --name tim-skills
+  hmgr source rename https://github.com/tim/skills.git meine-skills
+  hmgr source remove https://github.com/tim/skills.git
   hmgr source list
 
 Häufige Fälle:
   „Skill … liegt in keiner Quelle": die Quelle fehlt, erst source add, dann link.
   Neue Commits einer bekannten Quelle holt hmgr update, nicht source add.
+  „Quelle ist schon bekannt": dasselbe Repo steht schon im Zustand, hier in anderer Schreibweise.
+  „Quelle … ist nicht bekannt": source remove und source rename kennen nur geführte Quellen,
+  hmgr source list zeigt sie.
+  „Name … ist schon vergeben": einen anderen Namen wählen, mit --name bzw. source rename.
 
-Siehe auch: hmgr help link, hmgr help plugin, hmgr help update`;
+Siehe auch: hmgr help link, hmgr help plugin, hmgr help update, hmgr help status`;
 const DIR = `hmgr dir add <pfad> [--composer <pfad>]
 hmgr dir forget <pfad>
 hmgr dir list
@@ -52,10 +89,12 @@ hmgr dir list
 Ein Arbeitsverzeichnis ist ein Verzeichnis, in dem ein Harness gestartet wird. dir add merkt es und
 bindet es an seinen Zeiger, also an die composer.json, in deren extra-Abschnitt Quellen, Skills und
 Plugins des Vorhabens stehen. Ohne Zeiger bleibt das Verzeichnis gemerkt und jeder Link dort lokal
-(E26). dir forget löst Bindung und Eintrag, die gelegten Links bleiben liegen.
+(E26). dir forget löst Bindung und Eintrag, die gelegten Links bleiben liegen. Gebunden wird nur für
+Harnesses, die hmgr verwaltet: standardmäßig nur claude-code (E38).
 
 Schalter:
-  --composer <pfad>   composer.json wählen, wenn unter dem Verzeichnis mehrere in Frage kommen
+  --composer <pfad>   nur bei add: composer.json wählen, wenn unter dem Verzeichnis mehrere in
+                      Frage kommen
 
 Beispiele:
   hmgr dir add ~/Code/site
@@ -63,17 +102,21 @@ Beispiele:
   hmgr dir list
 
 Häufige Fälle:
-  „Mehrere composer.json unter …": eine mit --composer nennen, hmgr rät nicht.
+  „Mehrere composer.json unter …": hmgr fragt am Terminal, welche es ist. Ohne Antwort, etwa in
+  einem Script, bleibt der Fehler und --composer nennt sie, hmgr rät nicht.
   link --ort dir:<pfad> merkt das Verzeichnis von selbst. dir add braucht es vorher nur, wenn die
   composer.json mehrdeutig ist.
 
-Siehe auch: hmgr help link, hmgr help sync`;
+Siehe auch: hmgr help link, hmgr help sync, hmgr help harness`;
 const LINK = `hmgr link <skill> [schalter]
 
 Legt im Ziel einen Symlink auf den Skill an, der aus einer bekannten Quelle stammt, und trägt ihn
 in den Zeiger des Ziels ein, damit hmgr sync ihn anderswo reproduzieren kann. Einen Zeiger gibt es
 nur für ein Arbeitsverzeichnis mit composer.json, an Home und Profil bleibt jeder Link lokal.
 
+Das Schreiben in einen Zeiger ist gesperrt, bis das Composer-Thema entschieden ist (E57): an einem
+Arbeitsverzeichnis mit Zeiger bricht link ohne --local ab, der Link wird nicht gelegt.
+
 Schalter:
   --harness <name>    claude-code, hermes oder agents, Standard claude-code
   --ort <ort>         home, dir:<pfad> oder profil:<name>, Standard home. profil kennt nur hermes
@@ -101,6 +144,9 @@ const UNLINK = `hmgr unlink <skill> [schalter]
 Entfernt den Link aus dem Ziel und, wenn das Ziel an einen Zeiger gebunden ist, den Skill aus dem
 Zeiger. Der Checkout unter ~/.hmgr bleibt liegen, Links anderer Ziele bleiben unberührt.
 
+Das Schreiben in einen Zeiger ist gesperrt, bis das Composer-Thema entschieden ist (E57): an einem
+Arbeitsverzeichnis mit Zeiger bricht unlink ohne --local ab, der Link bleibt liegen.
+
 Schalter:
   --harness <name>    claude-code, hermes oder agents, Standard claude-code
   --ort <ort>         home, dir:<pfad> oder profil:<name>, Standard home. profil kennt nur hermes
@@ -123,6 +169,10 @@ ein Link stammt, nimmt deren remote.origin.url als Quelle, legt einen Checkout a
 und verlinkt den Skill daraus. Ohne Namen laufen alle fremden Einträge des Ziels durch, mit Namen
 nur dieser eine. Was sich nicht auflösen lässt, bleibt liegen und wird mit Grund gemeldet.
 
+Das Schreiben in einen Zeiger ist gesperrt, bis das Composer-Thema entschieden ist (E57): an einem
+Arbeitsverzeichnis mit Zeiger bricht adopt ohne --local ab, bevor etwas übernommen wird. Der
+Probelauf bleibt frei, er schreibt ohnehin nichts.
+
 Schalter:
   --harness <name>    claude-code, hermes oder agents, Standard claude-code
   --ort <ort>         home, dir:<pfad> oder profil:<name>, Standard home. profil kennt nur hermes
@@ -152,6 +202,10 @@ Plugin von dessen CLI installieren, sonst verlinkt es die flache Skill-Liste des
 seinen Abhängigkeiten. In den Zeiger kommt das Plugin, nicht seine Einzelskills. plugin list zeigt
 die Marketplaces aller bekannten Quellen mit ihren Plugins.
 
+Das Schreiben in einen Zeiger ist gesperrt, bis das Composer-Thema entschieden ist (E57): an einem
+Arbeitsverzeichnis mit Zeiger brechen add und remove ohne --local ab, nichts wird installiert,
+verlinkt oder entfernt.
+
 Schalter (add und remove):
   --harness <name>    claude-code, hermes oder agents, Standard claude-code
   --ort <ort>         home, dir:<pfad> oder profil:<name>, Standard home. profil kennt nur hermes
@@ -178,7 +232,8 @@ Bringt ein Arbeitsverzeichnis auf den Stand seines Zeigers: fehlende Quellen üb
 Links legen, Links auf einen anderen Ref umlegen, Plugins herstellen. Ohne Pfad gilt das aktuelle
 Verzeichnis. Das ist der Befehl nach einem frischen Clone eines Vorhabens und nach jeder Änderung
 am Zeiger. Eigene Links, die im Zeiger fehlen, werden als abweichend gemeldet und nicht entfernt,
-fremde Einträge bleiben unberührt.
+fremde Einträge bleiben unberührt. Eingerichtet wird nur für Harnesses, die hmgr verwaltet:
+standardmäßig nur claude-code (E38).
 
 Schalter: keine.
 
@@ -193,7 +248,7 @@ Häufige Fälle:
   hmgr unlink <skill> --ort dir:<pfad> --local entfernen.
   „Kein Harness auf diesem Rechner": weder ~/.claude noch ~/.hermes noch ~/.agents ist angelegt.
 
-Siehe auch: hmgr help dir, hmgr help link, hmgr help update`;
+Siehe auch: hmgr help dir, hmgr help link, hmgr help update, hmgr help harness`;
 const UPDATE = `hmgr update
 
 Holt für jeden Checkout unter ~/.hmgr den neuesten Stand seines Refs und zieht bei Harnesses mit
@@ -201,6 +256,11 @@ Plugin-Fähigkeit deren Plugins nach (E14). Die Links zeigen weiter auf dieselbe
 nicht erneuert werden. Ein Checkout mit lokaler Änderung wird übersprungen und gemeldet (E15),
 damit nichts verloren geht. Lokale Quellen haben keinen Checkout und bleiben unberührt.
 
+Danach räumt update verwaiste Ref-Verzeichnisse auf: Checkouts, in die kein Link mehr zeigt, weil
+ein Link inzwischen auf einen anderen Ref umgelegt wurde. Vor dem Löschen fragt hmgr einmal für
+alle Kandidaten. Ohne Bestätigung, also auch ohne Terminal, bleibt alles liegen und wird nur
+gemeldet. Ein verwaister Checkout mit lokaler Änderung wird nie gelöscht (E15).
+
 So wird eine Änderung an einem Skill überall wirksam: in der Quelle committen und pushen, dann
 hmgr update.
 
@@ -213,14 +273,18 @@ Häufige Fälle:
   „übersprungen … lokale Änderung (E15)": im Checkout liegt eine Änderung, die durch einen Link
   hindurch gemacht wurde. Dort committen und pushen, dann erneut hmgr update.
   „Keine Checkouts": es gibt nur lokale Quellen oder noch keinen Link.
+  „liegen lassen … ohne Bestätigung nicht gelöscht": die Frage kam ohne Ja zurück, etwa in einer
+  Pipe oder einem Composer-Script. In einem Terminal erneut hmgr update aufrufen.
 
 Siehe auch: hmgr help sync, hmgr help status`;
 const STATUS = `hmgr status
 
 Liest den Ist-Zustand vom Dateisystem: je Ziel eines vorhandenen Harness die Einträge mit Quelle
-und Ref, davor die Versionseinschränkung, falls der Zeiger eine nennt. Fremde Einträge und Links
-ohne bekannte Quelle sind eigens gekennzeichnet, dazu kommen die Plugins des Ziels. Am Ende stehen
-die Harnesses, die auf diesem Rechner nicht liegen.
+und Ref, davor die Versionseinschränkung, falls der Zeiger eine nennt. Dahinter steht der
+abgeleitete Grund des Links: das Plugin, zu dem er gehört, oder „über Zeiger", von Hand gelegte
+Links bleiben ohne Zusatz. Fremde Einträge und Links ohne bekannte Quelle sind eigens
+gekennzeichnet, dazu kommen die Plugins des Ziels. Am Ende stehen die Harnesses, die auf diesem
+Rechner nicht liegen.
 
 Schalter: keine.
 
@@ -235,6 +299,58 @@ Häufige Fälle:
   überspringt seine Ziele.
 
 Siehe auch: hmgr help adopt, hmgr help sync`;
+const HARNESS = `hmgr harness list
+hmgr harness enable <name>
+hmgr harness disable <name>
+hmgr harness skills-dir <name> [--profil <name>]
+hmgr harness skills-dir <name> add <pfad> [--profil <name>]
+hmgr harness skills-dir <name> remove [--profil <name>]
+
+Welche Harness-Typen hmgr verwaltet, ist eine Einstellung, kein gescannter Zustand: nur für aktive
+Harnesses richten dir add und sync Ziele ein, standardmäßig nur claude-code (E38). harness list zeigt
+alle bekannten Harness-Typen mit ihrem Stand: aktiv oder inaktiv, dazu vorhanden oder nicht vorhanden
+(auf diesem Rechner installiert oder nicht). enable und disable sind idempotent, ein zweites Mal
+ändert nichts und ist kein Fehler.
+
+disable säubert nicht von selbst: liegen noch eigene Links oder eine harness-eigene Konfiguration wie
+Hermes' external_dirs-Eintrag, fragt hmgr, ob sie entfernt werden sollen. Ohne Terminal, etwa in einem
+Script, gilt Nein und die Konfiguration bleibt liegen. Ein Link mit ausdrücklich genanntem --harness
+(hmgr link, hmgr plugin add) legt weiterhin an jedem vorhandenen Harness an, aktiv oder nicht, das ist
+Sache des Nutzers.
+
+skills-dir zeigt, legt fest oder entfernt den Ordner, aus dem Hermes externe Skills liest
+(skills.external_dirs in seiner config.yaml, E13, E56). hmgr verwaltet je Ziel (Home oder ein Profil
+mit --profil) genau einen Eintrag, den ersten unterhalb des Hermes-Home, ohne Hermes' eigenen Ordner
+„skills"; alle anderen Einträge der config.yaml rührt hmgr nicht an. add erlaubt nur einen Pfad
+unterhalb des Hermes-Home und legt ihn an, falls er fehlt; ein zweiter add ohne vorheriges remove ist
+ein Fehler. remove löscht nur den Eintrag aus der config.yaml, der Ordner bleibt liegen; danach fragt
+hmgr (mit Inhaltsangabe), ob der Ordner samt Inhalt gelöscht werden soll. Ohne Terminal, etwa in einem
+Script, gilt Nein und der Ordner bleibt liegen, ohne weitere Meldung. Ohne verwalteten Eintrag richtet
+das nächste hmgr link wieder den Standard-Ordner external-skills ein (E13). Hermes übernimmt eine
+Änderung an external_dirs ohne Neustart.
+
+Schalter (nur skills-dir):
+  --profil <name>   Ziel ist das genannte Profil statt Home
+
+Beispiele:
+  hmgr harness list
+  hmgr harness enable hermes
+  hmgr harness disable hermes
+  hmgr harness skills-dir hermes
+  hmgr harness skills-dir hermes add ~/.hermes/external-skills
+  hmgr harness skills-dir hermes remove --profil researcher
+
+Häufige Fälle:
+  „ist kein bekannter Harness-Typ": hmgr harness list zeigt die bekannten Namen.
+  Konfiguration bleibt nach disable liegen, wenn die Rückfrage mit Nein oder ohne Terminal beantwortet
+  wird. Ein erneutes hmgr harness disable <name> bietet das Säubern wieder an.
+  „kennt keinen verwalteten Skill-Ordner": skills-dir kennt heute nur hermes.
+  „ist schon ein Skill-Ordner verwaltet": erst hmgr harness skills-dir <name> remove, dann add.
+  „ist kein Skill-Ordner verwaltet": remove kennt nur einen vorhandenen Eintrag, add legt ihn fest.
+  „liegt nicht unterhalb des Hermes-Home" oder „ist Hermes' eigener Skill-Ordner": einen anderen
+  Pfad unter ~/.hermes (bzw. dem Profil-Ordner) nennen, nicht „skills" selbst.
+
+Siehe auch: hmgr help dir, hmgr help sync, hmgr help status`;
 /** Ebene 2, je Kommandofamilie ein Text. Unterkommandos teilen sich die Hilfe ihrer Familie. */
 const THEMEN = new Map([
     ['source', SOURCE],
@@ -246,6 +362,7 @@ const THEMEN = new Map([
     ['sync', SYNC],
     ['update', UPDATE],
     ['status', STATUS],
+    ['harness', HARNESS],
     ['help', HILFE],
 ]);
 /** Hilfetext zu einem Kommando, undefined für ein unbekanntes Thema. */