Pakete verwenden
add
genpm add @core/billing # neueste Version
genpm add @core/auth@^1.2 # SemVer-Bereich
genpm add @core/db --dest packages/db
genpm add @core/billing --dry-run # zeigt den Plan, schreibt nichtsGenPM stellt drei getrennte Fragen: den Code injizieren, MCP-Server hinzufügen (mit dem vollständigen Befehl) und den Befehl des Paketmanagers für npm-Abhängigkeiten ausführen. --yes beantwortet nur die erste; nutze --mcp und --install-deps für die anderen.
Existiert das Ziel und ist nicht leer, schlägt add mit E_DEST_CONFLICT fehl. --force verschiebt den alten Inhalt vorher nach .genpm/backup/<timestamp>/.
search und info
genpm search stripe
genpm info @core/billing # Manifest, Abhängigkeiten, MCP, Umgebungsvariablen und die vollständigen KI-Regeln
genpm info @core/billing --rules # nur die Regelnlist und remove
genpm list
genpm remove @core/authlist vergleicht jede injizierte Datei mit ihrem gespeicherten SHA-256 (lokale Änderungen). remove löscht keinen Code, den du geändert hast (E_DRIFT): Nutze --keep-code, um ihn zu behalten, oder --force, um ihn trotzdem zu löschen. Ein Paket, von dem ein anderes abhängt, kann nicht zuerst entfernt werden (E_REQUIRED_BY). Beim Entfernen eines Pakets werden auch seine MCP-Server und von GenPM angelegte Dateien entfernt, die leer zurückbleiben.
outdated und audit
genpm outdated
genpm audit # in deiner CI als: npx @genpm-net/cli auditaudit prüft die Integrität der Dateien, die Registry-Signatur jedes Lock-Eintrags, Sicherheitshinweise, zurückgezogene Versionen und Quarantänen. Bei hohen oder kritischen Befunden endet es mit Code 6.
update und diff
genpm diff @core/auth
genpm update @core/authdiff zeigt, was sich upstream seit deiner installierten Version geändert hat, mit Pfaden, die bereits auf deinen Ordner zeigen (anwenden mit git apply --3way). update führt einen Drei-Wege-Merge aus: Dateien, die du nicht angefasst hast, erhalten die neue Version, deine geänderten Zeilen bleiben erhalten, und wenn beide Seiten dieselben Zeilen geändert haben, bleibt die Datei mit den üblichen <<<<<<<-Markern stehen und der Befehl endet mit Code 4. Eine upstream entfernte Datei, die du geändert hast, bleibt erhalten.
genpm diff --local listet auch deine lokalen Änderungen; genpm update --dry-run zeigt den Plan, ohne etwas zu schreiben.
JSON-Ausgabe
Jeder Befehl akzeptiert --json (eine Zeile, auf Englisch, ohne Rückfragen). Ohne interaktives Terminal schlägt jede unbeantwortete Frage mit E_CONFIRM_REQUIRED fehl (Exit-Code 2), und es wird nichts geschrieben.
Rezepte: mehrere Pakete auf einmal
Ein Rezept installiert mit einem Befehl mehrere zusammenpassende Pakete, mit demselben Plan und denselben Fragen wie genpm add. Von GenPM kuratierte Rezepte findest du unter /recipes; dein Team kann auch ein eigenes als JSON-Datei im Repository pflegen.
genpm compose --list
genpm compose saas-starter --dry-run
genpm compose ./stack.json{ "name": "my-stack", "p": ["@core/db", "@core/auth@^1.2"] }Private Registries
Teams können Pakete aus privaten Repositories in einem privaten Registry halten (genpm registry create acme --owner meine-org oder Einstellungen › Private Registries). Für Nicht-Mitglieder existiert es nicht. Verweise deinen Scope in .genpmrc darauf und melde dich dort an; genpm add funktioniert wie gewohnt. Mitglieder lesen internal-Pakete; private-Pakete brauchen eine Berechtigung (genpm access grant @acme/api team:meine-org/backend read). Die GitHub-App von GenPM muss in der Organisation installiert sein, damit das Registry ihre privaten Repositories lesen kann.
# .genpmrc
@acme:registry=https://api.genpm.net/r/acme
# ENT-03: policy
policy=https://api.genpm.net/r/acmegenpm login --registry https://api.genpm.net/r/acme
genpm add @acme/payments