Cloudrouter – Das Skill, mit dem Claude Code/Codex Cloud-VMs und GPUs starten kann

• Ein Tool, mit dem AI-Coding-Agenten direkt in der Befehlszeile Cloud-Sandboxes erstellen und steuern können; VM- und GPU-Instanzen werden automatisch gestartet
• Erstellt Remote-Entwicklungsumgebungen aus lokalen Verzeichnissen oder Git-Repositories und unterstützt verschiedene Zugriffswege wie VS Code, Jupyter, VNC und Terminal
• Über die Chrome-CDP-Integration lassen sich Automatisierungen wie Browser-Navigation, Eingaben, Klicks, Screenshots und Data Scraping über die CLI ausführen
• Bietet fein granulare Ressourcensteuerung wie Datei-Upload/-Download und automatische Synchronisierung, GPU-Auswahl (--gpu H100:2 usw.) und Größenanpassung (--size small usw.)
• Open Source (MIT). Verfügbar für macOS, Linux und Windows

---

Überblick

• cloudrouter ist ein CLI-basiertes Skill, mit dem AI-Coding-Agenten wie Claude Code, Codex und Cursor VM- und GPU-Sandboxes in der Cloud erstellen und verwalten können
  • Direkt in der Befehlszeile lassen sich Sandboxes anlegen, Befehle ausführen, Dateien übertragen und Browser-Automatisierung nutzen
  • Installation mit dem Befehl npx skills add manaflow-ai/cloudrouter

Installation und Authentifizierung

• Kann als Skill für AI-Agenten hinzugefügt oder als eigenständige CLI installiert werden
  • Nach npm install -g @manaflow-ai/cloudrouter erfolgt die Anmeldung mit cloudrouter login
  • Sowohl die Befehle cloudrouter als auch cr können verwendet werden

Hauptfunktionen

• Sofort einsatzbereite Cloud-Sandboxes: Remote-VMs aus lokalen Verzeichnissen, Git-Repositories oder Templates erstellen
  • Einschließlich Docker-Unterstützung und automatischer Dateisynchronisierung
• AI-Agenten-Integration: Direkt aus Claude Code, Cursor usw. Sandboxes erstellen, Code ausführen und Browser-Automatisierung nutzen
• Browser-Automatisierung: Auf Basis von Chrome CDP sind Navigation, Klicken, Eingaben, Screenshots und die Analyse des Accessibility Tree möglich
• Mehrere Zugriffsarten: Unterstützt VS Code im Browser, VNC-Desktop, Terminal und das Ausführen einzelner Befehle
• Dateiübertragung: Bietet Upload/Download sowie automatisches erneutes Hochladen bei erkannten Änderungen
• Open Source: MIT-Lizenz, in Go geschrieben, als npm-Paket für macOS, Linux und Windows verteilt

GPU- und Instanzoptionen

• Standard-Sandboxes sind sofort nutzbar; mit der Option --gpu können GPU-Instanzen hinzugefügt werden
  • Beispiel: --gpu H100:2 verwendet zwei H100-GPUs
• GPU-Typen und Einsatzzwecke
  • T4 (16GB) : Inferenz und Fine-Tuning kleiner Modelle
  • L4 (24GB) : Bilderzeugung
  • A10G (24GB) : Training mittelgroßer Modelle
  • L40S (48GB) : Videoerzeugung
  • A100 (40GB) : Training großer Modelle (7B–70B)
  • H100 (80GB) , H200 (141GB) , B200 (192GB) : Für High-Performance-Forschung und Frontier-Modelle

Browser-Automatisierung

• Jede Sandbox enthält einen integrierten Browser mit Chrome-CDP
  • URLs öffnen, Accessibility-Tree-Snapshots erstellen, mit Elementen interagieren und Screenshots aufnehmen
  • Beispiel:
    • cloudrouter browser open cr_abc123 "https://example.com";
    • cloudrouter browser fill cr_abc123 @e1 "[e-mail]"
    • cloudrouter browser click cr_abc123 @e3

Sandbox-Verwaltung

• Bietet Verwaltungsbefehle zum Auflisten laufender Sandboxes, Prüfen des Status sowie Stoppen und Löschen
  • cloudrouter ls, cloudrouter stop , cloudrouter delete
• Unterstützt Pausieren (stop) und Fortsetzen (resume), außerdem das Verlängern von Timeouts (extend)
• Es gibt ein Limit von maximal 10 gleichzeitig laufenden Sandboxes

Dateiübertragung und Synchronisierung

• Unterstützt bidirektionale Dateiübertragung zwischen lokalem System und Sandbox
  • Upload: cloudrouter upload ./src
  • Download: cloudrouter download ./dist
  • Automatischer Upload bei Änderungs­erkennung (--watch) und Ausschlussmuster (-e "*.log") können konfiguriert werden

Zugriff auf die Entwicklungsumgebung

• Bietet verschiedene Remote-Entwicklungsoberflächen
  • VS Code: cloudrouter code
  • Jupyter Lab: cloudrouter jupyter
  • VNC-Desktop: cloudrouter vnc
  • Terminal-Sitzung: cloudrouter pty

Sicherheitsrichtlinien

• E2B-Port-Forwarding-URLs sind ohne Authentifizierung öffentlich und dürfen daher niemals geteilt werden
  • Stattdessen können nur VNC-, VS-Code- und Jupyter-URLs sicher geteilt werden
  • Der Zugriff auf Entwicklungsserver erfolgt über cloudrouter vnc

Leitfaden zur Fehlerbehebung

• Bei npm install-Fehlern: Der Befehl sudo chown -R 1000:1000 /home/user/.npm ist erforderlich
• Wenn der ssh-Befehl fehlschlägt: Der gesamte Befehl muss in Anführungszeichen gesetzt werden
• Wenn Browser-Befehle fehlschlagen: Nach dem Erstellen der Sandbox kurz warten
• Wichtige typische Fehler werden genannt, etwa die falsche Reihenfolge des snapshot-Flags oder die fehlerhafte Verwendung von extend

Open Source und Support

• Unter MIT-Lizenz veröffentlicht, Code auf GitHub verfügbar
• Unterstützt macOS, Linux und Windows
• Offizielle Kanäle: GitHub, Twitter, Discord

[GN⁺]

Hacker-News-Kommentare

• Es fühlt sich an, als wären wir dem Punkt einen Schritt näher gekommen, an dem Modelle mit ihren eigenen Weight-Dateien booten und sich selbst ausführen können
• Wirklich großartig! Ich habe es in meiner lokalen Umgebung mit cloudrouter start . ausprobiert, und es wurde nach einem Passwort für die Server-Authentifizierung gefragt
  Deshalb habe ich ein Issue eröffnet
  • Ich habe die Ursache gefunden und behoben. Bitte das Paket aktualisieren und es erneut versuchen
• Die Idee ist gut, aber persönlich bevorzuge ich keine monolithische Struktur
  Wenn man viele Funktionen zwanghaft in ein einziges Tool packt, wird es schwer, Änderungen vorzunehmen oder es zu erweitern, und die Flexibilität sinkt
  Ich bevorzuge kleine, lose gekoppelte, komponentenartige Tools. So können Nutzer sie leichter selbst anpassen oder kombinieren
  Das Docker-Template bündelt mehrere Apps in einem Container, was den Aufwand für Build, Support und Kompatibilität erhöht
  Es ist besser, jede App in einem eigenen Container zu haben und sie über TCP, Sockets oder Volumes zu verbinden
  Außerdem ist es ein Zeichen geringer Kohäsion, wenn Browser-Logik in den Authentifizierungscode gemischt wird
  Und ich habe im rsync-Code gesehen, dass die SSH-Host-Key-Prüfung deaktiviert wird, was ein großes Sicherheitsrisiko darstellt
  • Wenn man Templates bereitstellt, die vom Nutzer überschrieben werden können, ließe sich dieses Problem bis zu einem gewissen Grad lösen
    Ich habe mich für eine monolithische Struktur entschieden, um einen schnellen Start und Einfachheit zu ermöglichen, aber dafür ist die Konfigurationsfreiheit geringer
    Beim Docker-Template ist das Ziel, dass der Agent das Arbeitsverzeichnis hochlädt und sofort eine Entwicklungsumgebung startet
    Wenn man es auf mehrere Container aufteilt, steigen Komplexität bei Mounts, Networking usw.
    SSH verbindet sich nicht direkt mit dem eigentlichen Host, sondern wird über TLS WebSocket getunnelt
    Es werden sitzungsbezogene Auth-Tokens und temporäre VM-Schlüssel verwendet, sodass der SSH-Port nicht nach außen exponiert ist
• Das war eine hervorragende Demo
• Wir bauen bei dstack ebenfalls etwas Ähnliches
  Vor Kurzem haben wir Agent-Support hinzugefügt
  Unser Fokus liegt auf Container-Orchestrierung von Entwicklung bis hin zu Training und Inferenz
• Ich frage mich, ob es einen Grund gibt, warum man den Agenten nicht einfach die AWS-/Azure-/GCP-CLI verwenden lässt
  • Gute Frage. Aber es ist praktisch, mit einem Einzeiler sofort eine VM zu starten, bei der SSH, Dateisynchronisierung, Browser und GPU bereits bereitstehen
    Es entfällt der Aufwand für Cloud-Account-Setup, Security Groups und die Verwaltung von SSH-Schlüsseln
    cloudrouter enthält Docker/VNC/Jupyter Lab bereits vorab, sodass man sich nicht um die Umgebungs-Konfiguration kümmern muss
  • Es ist zwar möglich, aber Tools sind auch wertvoll, wenn sie es der KI erlauben, mit weniger Tokens Aufgaben auszuführen
  • Nichts hindert einen daran
• Wirklich erstaunlich
• Die Demo war wirklich beeindruckend
• Es hat durchgehend Spaß gemacht zu lesen