mage-remote-run

Wer in den letzten 15 Jahren im Magento-Ökosystem unterwegs war, kenn mich eventuell durch das Tool n98-magerun. Es ist das „Schweizer Taschenmesser“ der Magento Entwickler und Administratoren der direkt auf dem Server oder in seiner lokalen Umgebung arbeitet. Aber die Welt des E-Commerce-Hostings hat sich massiv weiterentwickelt.

Mit dem Aufstieg von Cloud-native Architekturen stehen wir heute oft vor einer ganz neuen Herausforderung: Wir stehen vor einer verschlossenen Tür.

Die Absicht: Wenn die Shell zur Sackgasse wird

Mein Ziel mit n98-magerun2 war es immer, Entwicklern maximale Effizienz auf der Konsole zu ermöglichen. Doch in modernen Umgebungen wie Adobe Commerce as a Cloud Service (SaaS) oder hochgradig abgesicherten Kubernetes-Clustern gibt es oft schlichtweg keinen SSH-Zugriff mehr. Security-Policies und Compliance-Vorgaben verhindern den direkten Weg auf den Server oder die Datenbank.

Hier entstand die Idee für mage-remote-run. Die Absicht war nicht, n98-magerun2 zu ersetzen – für die lokale Arbeit mit Tools wie DDEV bleibt es unersetzlich da es direkt im System arbeiten kann. Die Vision war vielmehr, ein Werkzeug zu schaffen, das auch per Remote funktioniert. Es sollte mit allen meinen Magento-Instanzen arbeiten. Es sollte ohne große Einrichtung funktionieren.

Die Idee: API-first statt Shell-first

Mage Remote Run verfolgt einen radikalen API-first Ansatz. Anstatt zu versuchen, Code innerhalb der Infrastruktur auszuführen, kommuniziert das Tool von außen über standardisierte HTTPS- und REST-Schnittstellen mit dem Shop.

Das Kernkonzept basiert auf drei Säulen:

• Remote-First Management: Volle Kontrolle über Produkte, Bestellungen und Systemkonfigurationen, ganz ohne Shell-Zugriff.
• Plattform-Agnostisch: Es ist egal, ob die Instanz in der Adobe Commerce Cloud als SaaS oder PaaS, bei einem spezialisierten Hoster mit Magento Open Source oder als Mage-OS Instanz läuft.
• Moderne Distribution: Als Node.js-basiertes Tool ist es entkoppelt von der lokalen PHP-Umgebung und lässt sich nahtlos in moderne Workflows integrieren.
• Mehrer Instanzen verwalten: Es lassen sich Connections zu mehreren Instanzen konfigurieren.

Hat das nicht einen Haken?

Das Konzept hat nur einen Haken. Es ist auf die Möglichkeiten der API beschränkt. Bietet die API eine Funktion nicht an, dann kann ich diese auch nicht aufrufen.
Mit dem Aufkommen einer reinen SaaS Lösung wie Adobe Commerce as a Cloud Service ist es aber per se nicht mehr möglich am Backend-Code Änderungen direkt vorzunehmen. Daher muss Adobe hier selbst schauen, dass man möglichst viele Funktionen per API abdeckt.

Bei der PaaS Variante oder bei On-Premises Systemen kann die API natürlich auch weiterhin erweitert werden. Spezielle selbst angelegte Endpunkte kennt das Tool nicht unebdingt.
Für diesen Fall habe ich ein generisches "rest" Kommando angelegt über das man sehr einfach beliebige Endpunkte mit der aktuell konfigurierten Verbindung ansteuern kann.

Premiere beim Adobe Commerce APAC User Group Event

Ich freue mich besonders, dass ich die Gelegenheit hatte, Mage Remote Run erstmals offiziell im Rahmen der Adobe Commerce APAC User Group am 5. Februar 2026 vorzustellen. Unter dem Titel „Architecting Remote Operations“ konnte ich der Community zeigen, wie wir die Lücke zwischen lokaler Developer Experience und restriktiven Cloud-Umgebungen schließen.

Das Video der Session mit der kompletten Live-Demo findet ihr hier eingebettet:

Im Video gehe ich auch auf den einen oder anderen Use-Case ein und zeige auch wie man mit dem Tool Produkte importieren kann oder es in einer GitHub Action verwendet.

Ein Blick in die Zukunft: KI und MCP

Ein zentraler Bestandteil meiner Vision ist die Vorbereitung auf eine Welt, in der wir Systeme nicht nur über manuelle Befehle steuern. Durch die Unterstützung des Model Context Protocol (MCP) ist Mage Remote Run bereits „AI-Ready“. Es erlaubt KI-Agenten, sicher auf Shop-Daten zuzugreifen und administrative Aufgaben durch natürliche Sprache zu lösen. Generell ist die Funktion aber noch mit Vorsicht zu nutzen. Es gibt bisher auch keine Möglichkeit die Funktion auf rein lesende Kommandos einzuschränken.

Beispiel:

mage-remote-run rest V1/products -m GET --page-size 1 --current-page 1 --format json

Du willst auch mal testen?

Für die Ausführung des Tools wird nur eine einigermaßen neue NodeJS Installation benötigt. Ist diese vorhanden, dann kann man es sehr einfach nutzen.

npm install -g mage-remote-run

Oder Sandboxed:

npx mage-remote-run

Eine Dokumentation findet man hier: https://mage-remote-run.muench.dev

Viel Spaß beim ausprobieren!