Engine-Befehle

Übersicht aller verfügbaren Engine-Befehle (pc engine). Jeder Befehl hat eine eigene Detailseite mit Syntax, Optionen und Beispielen.

Befehlsübersicht

Authentifizierung

Befehl	Alias	Beschreibung
`pc engine login`	-	Beginnt oder erneuert eine Session mit einer Engine
`pc engine logout`	-	Beendet die aktuelle Session
`pc engine session-status`	`st`	Zeigt den Status der aktuellen Session
`pc engine generate-root-access-token`	`token`	Generiert ein Root-Access-Token

Deployment

Befehl	Alias	Beschreibung
`pc engine deploy-files`	`deploy`	Transportiert BPMN-Diagramme auf die Engine
`pc engine remove-process-models`	`remove`	Entfernt Prozessmodelle von der Engine

Prozesssteuerung

Befehl	Alias	Beschreibung
`pc engine start-process-model`	`start`	Startet eine neue Prozessinstanz
`pc engine stop-process-instance`	`stop`	Stoppt laufende Prozessinstanzen
`pc engine retry-process-instance`	`retry`	Startet fehlgeschlagene Prozessinstanzen neu

Abfragen

Befehl	Alias	Beschreibung
`pc engine list-process-models`	`lsp`	Listet, sortiert und filtert Prozessmodelle
`pc engine list-process-instances`	`lsi`	Listet, sortiert und filtert Prozessinstanzen
`pc engine show-process-instance`	`show`	Zeigt Details zu einzelnen Prozessinstanzen
`pc engine list-user-tasks`	`lsu`	Listet User Tasks auf
`pc engine finish-user-task`	`finish`	Schließt einen User Task ab
`pc engine list-manual-tasks`	`lsmt`	Listet Manual Tasks auf
`pc engine finish-manual-task`	`finish-mt`	Schließt einen Manual Task ab
`pc engine list-untyped-tasks`	`lsut`	Listet Untyped Tasks auf
`pc engine finish-untyped-task`	`finish-ut`	Schließt einen Untyped Task ab

Weitere Namespaces

Namespace	Beschreibung	Dokumentation
`pc studio`	Studio-Steuerung via MCP	Studio-Befehle
`pc skill`	AI-Skill-Verwaltung	AI-Skills
`pc platform`	Erweiterungsmanagement	install-extension, create-extension

Allgemeine Optionen

Alle Befehle unterstützen folgende Optionen:

Option	Beschreibung
`--help, -h`	Zeigt die Hilfe für den Befehl an
`--version`	Zeigt die installierte Version der CLI
`--output, -o`	Steuert das Ausgabeformat: `text` oder `json` (Standard: `text`)

JSON-Output für Automatisierung

Für Skripte und Automatisierung verwenden Sie das JSON-Ausgabeformat:


# Output in Variable speichern
MODELS=$(pc engine list-process-models --output json)
 
# Mit jq verarbeiten
pc engine list-process-models --output json | jq '.result[] | .name'

Piping

Befehle können über den Pipe-Operator (|) miteinander verkettet werden. Details finden Sie im Kapitel Template-Pipes.


# Fehlgeschlagene Instanzen erneut versuchen
pc engine lsi --filter-by-state error | pc engine retry {{.processInstanceId}}
 
# Deployen und direkt starten
pc engine deploy-files process.bpmn | pc engine start {{.processModelId}}

Rückwärtskompatibilität

Alle bisherigen Befehle ohne Namespace funktionieren weiterhin:


# Diese Aufrufe sind gleichwertig:
pc engine deploy-files *.bpmn
pc deploy-files *.bpmn