SuperHQ

Qu'est-ce que SuperHQ ?

SuperHQ exécute des agents de codage IA dans des « sandboxs réels » isolés afin que les agents travaillent dans un environnement contrôlé plutôt que directement sur votre machine locale. Il orchestre Claude Code, OpenAI Codex et des agents personnalisés, chacun dans sa propre microVM.

L'objectif principal est de vous aider à exécuter en toute sécurité des modifications de code pilotées par des agents : votre projet est monté dans la sandbox (à /workspace), les changements sont capturés en overlay jusqu'à votre approbation, et vous pouvez inspecter un diff unifié avant que quoi que ce soit ne touche vos fichiers locaux.

Fonctionnalités clés

• Isolation microVM par agent : Chaque agent Claude Code, Codex ou personnalisé s'exécute dans sa propre microVM, gardant l'espace de travail isolé.
• Environnement Linux complet via une VM Debian : La sandbox est une VM Debian avec des outils comme apt, plus npm et pip, pour que l'agent puisse installer et exécuter les dépendances nécessaires.
• Espace de travail projet monté à /workspace : Votre projet est monté dans la sandbox ; les modifications des agents ciblent ce chemin monté.
• Changements en overlay avec validation : Les changements effectués dans la VM restent en overlay jusqu'à ce que vous les approuviez dans le panneau de revue.
• Revue de diff unifié avant application locale : Vous visualisez un diff unifié des modifications de l'agent et choisissez ce que vous gardez ou supprimez.
• Redirection de ports en opt-in : Les ports peuvent être redirigés de la sandbox vers l'hôte uniquement quand vous l'activez (utile pour serveurs de dev, bases de données et APIs).
• Points de contrôle et rewind : Vous pouvez arrêter et sauvegarder l'état de la VM, puis reprendre plus tard ; vous pouvez aussi forker un point de contrôle pour créer une nouvelle branche.

Comment utiliser SuperHQ

1. Installez SuperHQ sur macOS avec les commandes Homebrew fournies (brew tap superhq-ai/tap et brew install --cask superhq).
2. Créez un nouvel espace de travail pour votre projet (l'interface indique la création d'espace de travail et le basculement rapide via raccourcis clavier).
3. Démarrez un agent (l'interface liste Claude Code, OpenAI Codex et le support des agents personnalisés) pour effectuer des tâches de codage dans la sandbox.
4. Passez en revue les changements dans le panneau de revue : inspectez le diff unifié et approuvez ou rejetez les changements avant leur application à vos fichiers locaux.
5. Utilisez les contrôles sandbox selon les besoins : activez la redirection de ports uniquement pour accéder à un service dans la VM, et utilisez les points de contrôle pour pause/reprise ou fork d'une branche propre.

Cas d'usage

• Refactorisations pilotées par agent en sécurité pour un repo local : Exécutez un agent pour modifier du code dans une VM Debian isolée, passez en revue le diff unifié, et approuvez uniquement les parties souhaitées pour votre projet local.
• Tâches gourmandes en dépendances sans polluer votre machine : Laissez l'agent installer et exécuter des outils via l'environnement Debian de la sandbox (apt, npm, pip) plutôt que d'installer directement sur l'hôte.
• Débogage avec serveurs de dev temporaires : Activez la redirection de ports en opt-in pour accéder à des services (ex. serveur de dev ou API) dans la sandbox pendant l'inspection.
• Expérimentations itératives avec points de contrôle : Sauvegardez un état d'espace de travail, testez une approche, puis rewind ou fork pour lancer une nouvelle branche dans une autre direction.
• Exécution de workflows personnalisés avec agents custom : Utilisez l'option « agents personnalisés » pour des setups au-delà de Claude Code ou Codex, tout en gardant l'exécution dans des microVM par agent.

FAQ

• Que isolate SuperHQ ? Chaque exécution d'agent (Claude Code, Codex ou agent personnalisé) s'effectue dans sa propre sandbox microVM.

• Où se trouve mon projet pendant les exécutions d'agents ? Votre projet est monté dans la sandbox à /workspace.

• Comment les changements sont-ils appliqués à mes fichiers locaux ? Les modifications des agents restent en overlay jusqu'à approbation dans le panneau de revue. Un diff unifié est affiché pour garder ou rejeter les changements avant tout impact sur les fichiers locaux.

• La sandbox peut-elle exposer des services à mon hôte ? Oui, mais la redirection de ports est en opt-in, activée uniquement quand vous choisissez d'exposer des ports de la sandbox vers l'hôte.

• Comment fonctionnent les points de contrôle ? Vous pouvez arrêter un espace de travail et sauvegarder l'état complet de la VM, reprendre en quelques secondes, et forker un point de contrôle pour démarrer une branche fraîche.

Alternatives

• Flux de travail d’agents locaux (exécution directe sur votre machine) : Plus simples, mais généralement sans l’isolation microVM décrite, le contrôle d’approbation et le modèle d’overlay sandbox.
• Environnements de développement conteneurisés (ex. : configurations d’agents basées sur Docker) : Les conteneurs isolent dépendances et outils, mais le flux overlay-approbation spécifique et le comportement checkpoint/rewind microVM peuvent différer.
• Sandboxes distantes ou plateformes d’exécution de code hébergées : Elles offrent l’isolation, mais les flux de travail et l’emplacement de révision/application des changements peuvent varier par rapport au montage local de projet de SuperHQ à /workspace avec approbation de diffs unifiés.
• Assistants IA de codage intégrés à l’IDE sans sandbox : Ils se concentrent sur l’assistance en éditeur ; ils n’offrent pas d’isolation VM par agent, de révision de diffs avant application aux fichiers locaux, ni de redirection de ports opt-in liée à un runtime sandbox.