hmgr

hmgr verwaltet Skills und Plugins für AI-Harnesses auf den Rechnern eines Nutzers. Ein Harness ist ein Agentenprogramm, das Skills aus Verzeichnissen lädt, derzeit Claude Code und Hermes Agent. hmgr holt Skills aus Quellen, legt sie als Links in Ziele (Harness plus Ort, also Home, Profil oder Arbeitsverzeichnis) und hält sie aktuell. Welche Skills und Plugins zu einem Ziel gehören, steht in einem Zeiger, der an das Ziel gebunden ist.

Installation

Das Paket liegt öffentlich auf npmjs, es enthält nur dist/ und diese README.

npm install -g hmgr

Danach steht das Kommando hmgr bereit. Aus dem Repo geht es auch ohne Registry: npm pack baut dist/ und packt es, npm install -g hmgr-0.0.1.tgz installiert das Tarball.

Entwicklung

Node ab 22.6, weil im Entwicklungsmodus .ts direkt ausgeführt wird.

npm run dev -- <kommando>
npm test
npm run build

npm run dev startet src/cli/main.ts, npm run build erzeugt dist/.

GUI

npm run gui startet die Electron-Oberfläche im Dev-Modus (electron dist/gui/main.js).

npm run gui:app baut ein macOS-App-Bundle „hmgr.app" mit eigenem Icon und Namen im Dock/Finder (statt „Electron"), über electron-builder. Das Ergebnis liegt in release/mac-arm64/hmgr.app, dazu ein .zip zum Weitergeben. Nur arm64, unsigniert, keine Notarisierung, kein Auto-Update — für den lokalen Gebrauch. Das Icon (build/icon.icns) entsteht aus entwurf/icon/icon-1024.png.

npm run gui:app:win baut den Windows-Installer, auch auf dem Mac: NSIS braucht dort kein Wine, electron-builder lädt sich die nötigen Teile selbst. Es entsteht release/hmgr-Setup-<version>-x64.exe (rund 107 MiB) samt .blockmap, daneben die ungepackte App in release/win-unpacked/. Nur x64, installiert wird pro Benutzer nach %LOCALAPPDATA%\Programs\hmgr — ohne Administratorrechte, das Zielverzeichnis lässt sich im Installer ändern. Das Windows-Icon (build/icon.ico) erzeugt entwurf/icon/erzeuge-ico.py aus derselben icon-1024.png.

Der Installer ist nicht signiert. Windows SmartScreen meldet sich deshalb beim ersten Start mit „Der Computer wurde durch Windows geschützt"; der Weg dahinter führt über „Weitere Informationen" und „Trotzdem ausführen".

Kommandos

hmgr --help zeigt die Kommandos, hmgr help <kommando> Schalter, Beispiele und Zusammenhänge.