SuperHQ

Was ist SuperHQ?

SuperHQ führt AI-Coding-Agents in isolierten „echten Sandboxes“ aus, damit die Agents in einer kontrollierten Umgebung arbeiten können, statt direkt auf Ihrer lokalen Maschine. Es orchestriert Claude Code, OpenAI Codex und benutzerdefinierte Agents, jeweils in einer eigenen microVM.

Der Kernzweck ist, Ihnen zu helfen, agentengesteuerte Code-Änderungen sicher auszuführen: Ihr Projekt wird in die Sandbox eingehängt (unter /workspace), Änderungen werden in einer Overlay erfasst, bis Sie sie freigeben, und Sie können vor der Anwendung lokal eine Unified-Diff-Überprüfung durchführen.

Wichtige Funktionen

• MicroVM-Isolation pro Agent: Jeder von Claude Code, Codex und benutzerdefinierten Agents läuft in einer eigenen microVM, wodurch der Workspace isoliert bleibt.
• Vollständige Linux-Userland über Debian-VM: Die Sandbox ist eine Debian-VM mit Paket-Tools wie apt, plus npm und pip, damit der Agent Abhängigkeiten installieren und ausführen kann.
• Eingehängtes Projekt-Workspace unter /workspace: Ihr Projekt wird in die Sandbox eingehängt; Agent-Änderungen zielen auf diesen Pfad ab.
• Overlay-Änderungen mit Freigabe-Sperre: Änderungen in der VM bleiben in einer Overlay, bis Sie sie im Review-Panel freigeben.
• Unified-Diff-Review vor lokaler Anwendung: Sie sehen eine Unified Diff der Agent-Änderungen und können auswählen, was behalten oder verworfen wird.
• Optionales Port-Forwarding: Ports können von der Sandbox zum Host weitergeleitet werden, nur wenn Sie es aktivieren (nützlich für Dev-Server, Datenbanken und APIs).
• Checkpoint und Rücksetzen: Sie können den VM-Zustand stoppen und checkpoinen sowie später fortsetzen; ein Checkpoint kann auch geforkt werden, um einen frischen Branch zu erstellen.

So verwenden Sie SuperHQ

1. SuperHQ installieren auf macOS mit den bereitgestellten Homebrew-Befehlen (brew tap superhq-ai/tap und brew install --cask superhq).
2. Neuen Workspace für Ihr Projekt erstellen (die UI zeigt Workspace-Erstellung und schnelles Wechseln per Tastenkombinationen an).
3. Einen Agent starten (die Oberfläche listet Claude Code, OpenAI Codex und Unterstützung für benutzerdefinierte Agents), um Coding-Aufgaben in der Sandbox auszuführen.
4. Änderungen im Review-Panel prüfen: Unified Diff inspizieren und Änderungen freigeben oder verwerfen, bevor sie auf lokale Dateien angewendet werden.
5. Sandbox-Steuerungen bei Bedarf nutzen: Port-Forwarding nur aktivieren, wenn Zugriff auf einen in der VM laufenden Service benötigt wird, und Checkpoints für Pause/Fortsetzung oder Fork eines sauberen Branches verwenden.

Anwendungsfälle

• Sichere agentengesteuerte Refactorings für ein lokales Repo: Einen Agent in isolierter Debian-VM laufen lassen, um Code zu ändern, Unified Diff prüfen und nur gewünschte Teile für das lokale Projekt freigeben.
• Abhängigkeitsintensive Aufgaben ohne Verschmutzung der Maschine: Agent Tools in der Debian-Userland der Sandbox (apt, npm, pip) installieren und ausführen lassen, statt Pakete direkt auf dem Host.
• Debugging mit temporären Dev-Servern: Optionales Port-Forwarding aktivieren, um Services (z. B. Dev-Server oder API) in der Sandbox zu erreichen, während Verhalten geprüft wird.
• Iterative Experimente mit Checkpoints: Workspace-Zustand checkpoinen, Ansatz ausprobieren, dann zurücksetzen oder Checkpoint forken, um neuen Branch für andere Richtung zu starten.
• Benutzerdefinierte Workflows mit Custom Agents: „Custom Agents“-Option nutzen, wenn Setup über Claude Code oder Codex hinausgeht, bei isolierter Ausführung in per-Agent-microVM-Sandboxes.

FAQ

• Was isoliert SuperHQ? Jeder Agent-Lauf (Claude Code, Codex oder benutzerdefinierter Agent) wird in einer eigenen microVM-Sandbox ausgeführt.

• Wo befindet sich mein Projekt während Agent-Läufen? Ihr Projekt wird in die Sandbox unter /workspace eingehängt.

• Wie werden Änderungen auf meine lokalen Dateien angewendet? Agent-Änderungen bleiben in einer Overlay, bis Sie sie im Review-Panel freigeben. Eine Unified Diff wird angezeigt, damit Sie Änderungen behalten oder verwerfen können, bevor lokale Dateien betroffen sind.

• Kann die Sandbox Services zum Host freigeben? Ja, aber Port-Forwarding ist optional und wird nur aktiviert, wenn Sie Ports von der Sandbox zum Host freigeben.

• Wie funktionieren Checkpoints? Sie können einen Workspace stoppen und den vollständigen VM-Zustand checkpoinen, später in Sekunden fortsetzen und einen Checkpoint forken, um einen frischen Branch zu starten.

Alternativen

• Lokale Agent-Workflows (Agents direkt auf Ihrem Rechner ausführen): Diese sind einfacher, bieten aber meist keine microVM-Isolation, Genehmigungs-Gate und Sandbox-Overlay-Modell wie beschrieben.
• Containerisierte Entwicklungsumgebungen (z. B. Docker-basierte Agent-Setups): Container isolieren Abhängigkeiten und Tools, doch der spezifische Overlay-Genehmigungsfluss und das microVM-Checkpoint/Rücklauf-Verhalten können abweichen.
• Remote-Sandboxen oder gehostete Code-Ausführungsplattformen: Diese bieten Isolation, aber Workflows und der Ort der Code-Änderungsprüfung/Anwendung können von SuperHQs lokaler Projektmontage unter /workspace mit Unified-Diff-Genehmigung abweichen.
• IDE-integrierte AI-Coding-Assistenten ohne Sandboxing: Sie konzentrieren sich auf Editor-Hilfe; sie bieten meist keine pro-Agent-VM-Isolation, Diff-Prüfung vor Anwendung auf lokale Dateien oder opt-in Port-Forwarding an eine Sandbox-Runtime.