Agentbox - Bac à sable pour agents de codage

Il n'existe pas de méthode parfaite pour isoler les agents (pas encore), mais les conteneurs constituent un point de départ pratique.

Agentbox est un bac à sable Docker pour agents de codage, initialement inspiré par Batrachian Toad, et désormais généralisé à davantage d'outils. Il fournit un environnement isolé qui fonctionne bien avec webterm pour exécuter plusieurs sessions d'agents.

Fonctionnalités

Le conteneur par défaut fournit :

• Environnement de développement : Debian Stable avec les outils de développement courants
• Agents de codage préinstallés : Copilot CLI, Codex, Pi
• Outils CLI préinstallés : gh, Nushell, lazygit, killall
• Gestionnaires de paquets : Homebrew et APT, plus uv et Bun ; les builds du conteneur installent les derniers paquets disponibles sans épinglage de version exacte
• Outillage d'agent optionnel : installez toad, opencode, gemini et vibe via make -C ~ ...
• Contrôle des services : activez/désactivez Docker/SSH/RDP avec ENABLE_DOCKER, ENABLE_SSH et ENABLE_RDP
• Docker-in-Docker : disponible lorsque les conteneurs s'exécutent en mode privilégié
• Accès distant : SSH (ENABLE_SSH=true) et prise en charge de mosh
• Amorçage de l'espace de travail : squelette d'espace de travail intégré et compétences d'agent sous /home/agent/workspace-skel

Feuille de route

• Limites CPU et mémoire (contraintes de ressources Docker de base)
• Options d'isolation réseau
• Autres techniques de bac à sable (gVisor, Kata Containers, etc.)

Configuration des services

Agentbox utilise des variables d'environnement pour contrôler quels services démarrent au lancement du conteneur :

• ENABLE_DOCKER=true - Démarre le démon Docker (pour la prise en charge de Docker-in-Docker)
• ENABLE_SSH=true - Démarre le serveur SSH (port 22)
• ENABLE_RDP=true - Démarre le serveur RDP (port 3389)
• AGENTBOX_ENVIRONMENT=cli|gui - Marqueur d'environnement fourni par l'image (cli pour headless/CLI, gui pour les images de bureau)

Comportement par défaut : Tous les services sont désactivés sauf activation explicite.

Exemples :

# Default - all services disabled
docker run -d agentbox

# Enable only Docker daemon
docker run -d -e ENABLE_DOCKER=true agentbox

# Enable Docker and SSH for development
docker run -d -e ENABLE_DOCKER=true -e ENABLE_SSH=true -p 22:22 agentbox

# Full desktop experience with all services (GUI image)
docker run -d -e ENABLE_DOCKER=true -e ENABLE_SSH=true -e ENABLE_RDP=true -p 22:22 -p 3389:3389 agentbox:gui

Démarrage rapide

Installations d'outils optionnelles

À l'intérieur du conteneur, l'utilisateur agent dispose d'un ~/Makefile qui peut installer de l'outillage supplémentaire.

Agents de codage/CLI que vous pouvez installer via make -C ~ … :

• toad — installe Batrachian Toad (via uv tool)
• opencode — installe OpenCode (via Bun)
• gemini — installe Gemini CLI (via Homebrew)
• vibe — installe mistral-vibe (via uv tool)

Cibles de commodité :

• tools — installe node, go, gemini, vibe
• node, go — installe les chaînes d'outils de langage (prérequis pour certains agents)

Squelette d'espace de travail

Agentbox fournit un squelette de projet intégré à /home/agent/workspace-skel.

Pour le copier dans votre /workspace actuel sans écraser les fichiers existants :

make init-workspace

Voir docs/workspace-skeleton.md pour plus de détails.

Image GUI

La build GUI est publiée sous le tag :gui (également <release>-gui) et inclut XFCE, XRDP et VS Code.

Docker Compose

Flux de travail recommandé :

make up
make enter-toad   # or: make enter-copilot
make down

Si vous avez besoin de surcharges de service, créez docker-compose.override.yml :

services:
  toad:
    environment:
      ENABLE_DOCKER: "true"
      ENABLE_SSH: "true"
  copilot:
    environment:
      ENABLE_DOCKER: "true"
      ENABLE_SSH: "true"

Puis exécutez :

docker compose up -d

Utilisation directe de Docker

# Build the headless image
docker build -t agentbox .

# Build the GUI image
docker build -t agentbox:gui --target gui .

# Run the container with selected services (GUI image)
docker run -d \
  --name agentbox \
  --privileged \
  -e ENABLE_DOCKER=true \
  -e ENABLE_SSH=true \
  -e ENABLE_RDP=true \
  -p 22:22 \
  -p 3389:3389 \
  -v $(pwd):/workspace \
  agentbox:gui

Utilisation de Batrachian Toad

Une fois connecté au conteneur :

1. Installez Toad (si nécessaire) :

make -C ~ toad

2. Démarrez Toad :

toad

3. Ou démarrez avec un répertoire de projet spécifique :

toad /workspace

4. Ou lancez directement avec un agent :

toad -a open-hands

Notes de sécurité

• Contrôle des services : Par défaut, tous les services (Docker, SSH, RDP) sont désactivés. Activez explicitement uniquement ce dont vous avez besoin à l'aide des variables d'environnement.
• Les mots de passe par défaut sont faibles - changez-les pour une utilisation en production
• Le conteneur doit s'exécuter en mode privilégié pour que Docker-in-Docker soit disponible pour vos agents (c'est mieux que rien)
• Envisagez d'utiliser des clés SSH au lieu de l'authentification par mot de passe
• Pour une utilisation en production, envisagez de désactiver les services inutiles et de changer les identifiants par défaut

Crédits

Ce projet est vaguement basé sur mon ancien rcarmo/docker-templates/desktop-chrome avec un userland mis à jour.

Licence

MIT