AGENTBOX : isoler et paralléliser vos agents de code
📌 AGENTBOX est un outil qui déplace un projet dans une VM dédiée pour y lancer Claude Code, Codex ou OpenCode, en local ou chez un fournisseur cloud.
L’intérêt apparaît dès que plusieurs agents doivent travailler en même temps. Au lieu de partager le même dossier, les mêmes dépendances et le même terminal, chaque tâche reçoit sa propre box. Vous pouvez lancer une correction avec Claude, une autre avec Codex et garder OpenCode sur une troisième branche, sans mélanger leurs fichiers ni leurs processus.
La commande de départ reste volontairement simple : agentbox claude crée une box, copie le projet et les réglages nécessaires, puis ouvre l’agent dans une session tmux détachable. AgentBox peut aussi installer les dépendances du projet, démarrer les services Docker et conserver un shell persistant. Pour reprendre le travail, agentbox attach, agentbox shell ou agentbox dashboard évitent de reconstruire le contexte à chaque fois.
Ce qui rend l’outil plus complet qu’un simple script autour de Docker, c’est l’accès à une machine entière. Chaque environnement peut exposer une URL locale, ouvrir un navigateur via noVNC, accueillir un VS Code ou un Cursor dans la box et se connecter à des outils comme iTerm2, cmux, tmux ou Herdr. Le projet n’est pas seulement isolé : il reste accessible comme un poste de développement à distance.
Les checkpoints ajoutent une deuxième couche intéressante. Une box arrêtée conserve son volume supérieur, et un nouvel environnement peut repartir d’un état chaud en moins d’une seconde selon la promesse du projet. La mise en pause automatique permet aussi de ne pas laisser tourner inutilement une machine quand un agent attend une réponse ou qu’une tâche est terminée.
Quelques usages concrets :
- 📦 Créer une VM isolée pour chaque branche ou fonctionnalité
- 🤖 Faire travailler Claude Code, Codex et OpenCode en parallèle
- 🧪 Démarrer les services, dépendances et outils du projet dans chaque box
- 🌐 Ouvrir une preview web par une URL locale ou un navigateur intégré
- 🔁 Mettre en pause, reprendre et cloner des environnements via des checkpoints
- ⎇ Contrôler les branches, pull, push et demandes de permission Git
Je trouve la séparation particulièrement séduisante pour les tâches exploratoires. Un agent peut modifier une architecture ou lancer une migration sans risquer de perturber la session voisine. La possibilité de lire les plans et les demandes d’un agent comme des données, avec agentbox agent wait-for et get-plan, ouvre aussi la porte à une vraie orchestration plutôt qu’à une collection de terminaux côte à côte.
Il faut cependant regarder la facture technique. L’installation cible macOS ou Linux avec Docker Desktop ou OrbStack et Node.js 20.10 ou plus récent. La première création construit une image d’environ 1 Go. Les fournisseurs Hetzner, DigitalOcean, Vercel, E2B et Daytona ajoutent ensuite leurs propres comptes, tokens, particularités réseau et coûts. Une box locale est simple à comprendre ; une flotte de boxes cloud demande rapidement une vraie discipline d’exploitation.
La sécurité repose aussi sur une frontière qu’il faut vérifier. Le projet indique que les credentials Git restent sur la machine hôte et que l’envoi vers un dépôt distant passe par une demande explicite. Mais les skills, plugins, réglages et sessions d’agents sont justement destinés à être injectés dans l’environnement isolé. AgentBox réduit le rayon d’explosion d’une tâche, il ne rend pas un agent autonome inoffensif par magie.
AGENTBOX ressemble finalement à un poste de contrôle pour le développement assisté par agents. Il ne cherche pas à remplacer Claude, Codex ou OpenCode : il leur donne des bureaux séparés, reproductibles et récupérables. Pour un projet qui commence à faire travailler plusieurs agents en parallèle, cette couche d’infrastructure peut devenir plus importante que le choix du modèle lui-même.
Sources
