python-run und terminal-run

Diese direkten CLI-Wrapper nutzen dieselben Engines wie die MCP-Server, aber ohne JSON-RPC und ohne MCP-Client. Sie sind praktisch für Smoke-Tests, Shell-Skripte, Debugging lokaler Umgebungen und kleine Automatisierungen, bevor derselbe Ablauf später als MCP-Tool über AI Hub verwendet wird.

python-run

python-run akzeptiert den Code als einzelnes Argument oder liest ihn aus stdin. Mit --container-id bleibt der Python-Zustand zwischen Aufrufen erhalten: Variablen, Imports und die zugehörige UV-Umgebung werden einer Session zugeordnet.

ai-hub-cli python-run 'print(1 + 1)'
ai-hub-cli python-run --container-id analyse "x = 42"
ai-hub-cli python-run --container-id analyse "print(x)"
echo "import math; print(math.pi)" | ai-hub-cli python-run

Flag	Beschreibung
--container-id	Session-ID für persistenten Python-Zustand. Ohne Angabe nutzt der Wrapper eine neue bzw. Default-Session.

terminal-run

terminal-run führt genau einen Shell-Befehl aus. Der Befehl wird als Argument übergeben; anders als beim MCP-Tool gibt es hier keinen files-Parameter. Als MCP-Tool steht dieselbe Engine über Terminal Executor bereit.

ai-hub-cli terminal-run "echo hello"
ai-hub-cli terminal-run --background "npm run dev"
ai-hub-cli terminal-run --working-dir /pfad/zum/repo "ls -la"

Flag	Beschreibung
--background	Startet den Prozess im Hintergrund und gibt eine lokale Prozess-ID aus.
--working-dir	Setzt das Arbeitsverzeichnis für den Befehl.