finbarr/yoloboxLaissez votre IA aller plein gaz. Votre répertoire personnel reste à la maison.
██╗ ██╗ ██████╗ ██╗ ██████╗ ██████╗ ██████╗ ██╗ ██╗
╚██╗ ██╔╝██╔═══██╗██║ ██╔═══██╗██╔══██╗██╔═══██╗╚██╗██╔╝
╚████╔╝ ██║ ██║██║ ██║ ██║██████╔╝██║ ██║ ╚███╔╝
╚██╔╝ ██║ ██║██║ ██║ ██║██╔══██╗██║ ██║ ██╔██╗
██║ ╚██████╔╝███████╗╚██████╔╝██████╔╝╚██████╔╝██╔╝ ██╗
╚═╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝
Laissez votre IA y aller à fond. Votre répertoire personnel reste chez lui.
Docs : yolobox.dev
Changelog : CHANGELOG.md
Exécutez Claude Code, Codex, Kimi Code, Gemini, Antigravity, OpenCode, Copilot, Pi, ou n'importe quel agent de codage IA en « mode yolo » sans réduire en miettes votre répertoire personnel.
Les agents de codage IA sont incroyablement puissants lorsque vous les laissez exécuter des commandes sans demander la permission. Mais un prompt mal interprété et un rm -rf ~ plus tard, vous restaurez depuis une sauvegarde (ouais, c'est ça, comme si vous aviez des sauvegardes mdr).
yolobox exécute votre agent IA dans un conteneur où :
/Users/you/projectL'IA peut se déchaîner complètement à l'intérieur du bac à sable. Votre véritable répertoire personnel ? Intouchable.
# Install via Homebrew
brew install finbarr/tap/yolobox
# Or install via script
curl -fsSL https://raw.githubusercontent.com/finbarr/yolobox/master/install.sh | bash
Homebrew installe automatiquement les complétions bash et zsh. Pour les installations par script, voir shell completions.
Puis depuis n'importe quel projet :
cd /path/to/your/project
yolobox claude # Let it rip
Les autres raccourcis IA fonctionnent de la même manière :
yolobox codex
yolobox gemini
yolobox kimi
yolobox agy
yolobox antigravity
yolobox opencode
yolobox copilot
yolobox pi
Définissez default_harness = "codex" pour que yolobox seul lance Codex. Utilisez yolobox shell lorsque vous voulez un shell manuel, et yolobox run <cmd...> lorsque vous voulez exécuter une seule commande dans le bac à sable.
Les détails complets d'installation et d'exécution se trouvent dans Installation & Setup. Les exemples de commandes se trouvent dans Commands.
L'image de base est fournie avec les CLI d'IA, les adaptateurs ACP Codex et Claude, Node.js, Python, Go, Bun, les outils de compilation, Git, GitHub CLI, ripgrep, fd, fzf, jq, vim, RTK et les éléments pratiques habituels.
Besoin d'autre chose ? L'agent dispose de sudo.
Dans yolobox, les CLI d'IA pris en charge sont encapsulés pour ignorer les invites de permission. Aucune confirmation, aucune barrière de sécurité. Juste de l'IA pure et non filtrée, comme la nature l'a voulu.
Pour un client ACP ou un éditeur, utilisez yolobox run codex-acp ou yolobox run claude-agent-acp comme commande d'agent stdio. Les adaptateurs embarquent des moteurs compatibles et utilisent les modes de permission du client ; les wrappers YOLO de la CLI de yolobox et --no-yolo ne les contrôlent pas. Les options existantes de synchronisation de configuration et d'authentification s'appliquent. Voir ACP clients pour des exemples de lancement.
La progression du téléchargement de l'image et de la compilation d'une image personnalisée est envoyée vers stderr, laissant stdout et stdin redirigé pour la commande du conteneur, y compris pendant le démarrage d'ACP.
Pour la liste complète des outils, le tableau des wrappers en mode YOLO, les notes sur RTK, la politique de fraîcheur des paquets npm et le comportement de mise à niveau des CLI embarquées, voir What's in the Box.
Si un projet a besoin d'outils ou de variables d'environnement supplémentaires, ajoutez une petite configuration de projet au lieu de dupliquer toute l'image de base :
# .yolobox.toml
env = ["CODEX_HOME=/home/yolo/.codex-account"]
[customize]
packages = ["default-jdk", "maven"]
Puis exécutez normalement :
yolobox run mvn --version
La personnalisation au niveau du projet peut également superposer un fragment de Dockerfile sur l'image de base. La première exécution construit une image dérivée ; les exécutions suivantes la réutilisent tant que l'image de base ou les entrées de personnalisation ne changent pas.
Utilisez des chemins de conteneur pour les valeurs d'env, car elles sont transmises directement au processus à l'intérieur de yolobox. Les valeurs env sont transmises au runtime telles quelles ; rien en elles n'est interprété.
Pour fournir au bac à sable une valeur différente de celle utilisée par l'hôte sous le même nom — un jeton en lecture seule au lieu de votre vrai jeton — créez un alias avec env_from_host (ou --env-from-host KEY=HOST_VAR) :
# .yolobox.toml
env_from_host = ["GH_TOKEN=YOLOBOX_READONLY_GH_TOKEN"]
L'alias possède cette variable : il supprime le passthrough automatique et --gh-token pour la même clé, et yolobox refuse de démarrer si la variable hôte n'est pas définie, de sorte que le jeton qu'il remplace ne peut jamais fuiter par accident.
Voir Configuration pour les paramètres d'environnement du projet, et Project-Level Customization pour les installations de paquets, les fragments de Dockerfile, le comportement de reconstruction, le comportement de mise à niveau et les images entièrement personnalisées.
yolobox setup # Configure global defaults
yolobox config # Show resolved config for this project
yolobox claude --docker --gh-token # Give the agent Docker and GitHub access
yolobox claude --claude-config --no-claude-auth # Share config, keep the box login independent
yolobox copilot --copilot-config # Share Copilot settings, login, and session history
yolobox codex --rtk # Enable RTK command-output compression
yolobox run --no-network make test # Run one command with no network
yolobox fork --name bruno codex # Give an agent its own project copy
yolobox upgrade # Update binary and pull the latest image
yolobox update-agents # Update AI CLIs and ACP adapters in the persistent box
OpenCode s'installe et se met à jour en autorisant explicitement son script postinstall npm requis.