yolobox v0.19.4

██╗   ██╗ ██████╗ ██╗      ██████╗ ██████╗  ██████╗ ██╗  ██╗
╚██╗ ██╔╝██╔═══██╗██║     ██╔═══██╗██╔══██╗██╔═══██╗╚██╗██╔╝
 ╚████╔╝ ██║   ██║██║     ██║   ██║██████╔╝██║   ██║ ╚███╔╝
  ╚██╔╝  ██║   ██║██║     ██║   ██║██╔══██╗██║   ██║ ██╔██╗
   ██║   ╚██████╔╝███████╗╚██████╔╝██████╔╝╚██████╔╝██╔╝ ██╗
   ╚═╝    ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝  ╚═════╝ ╚═╝  ╚═╝

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 votre répertoire personnel en miettes.

Le problème

Les agents de codage IA sont incroyablement puissants quand 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 bien sûr, comme si vous aviez des sauvegardes mdr).

La solution

yolobox exécute votre agent IA dans un conteneur où :

• votre répertoire de projet est monté à son chemin réel, comme /Users/you/project
• l'agent dispose de toutes les permissions et de sudo à l'intérieur du conteneur
• votre répertoire personnel n'est pas monté sauf si vous l'autorisez explicitement
• des volumes persistants conservent les outils, configurations et sessions entre les exécutions
• Claude, Codex et Kimi Code bénéficient d'un guidage yolobox intégré pour comprendre le bac à sable dans lequel ils s'exécutent

L'IA peut faire absolument n'importe quoi à l'intérieur du bac à sable. Votre véritable répertoire personnel ? Intouchable.

Démarrage rapide

# Install via Homebrew
brew install finbarr/tap/yolobox

# Or install via script
curl -fsSL https://raw.githubusercontent.com/finbarr/yolobox/master/install.sh | bash

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 quand vous voulez un shell manuel, et yolobox run <cmd...> quand vous voulez 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.

Qu'y a-t-il dans la boîte ?

L'image de base est livrée avec les CLI 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.

À l'intérieur de yolobox, les CLI IA pris en charge sont enveloppés pour ignorer les demandes 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 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.

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és, voir What's in the Box.

Personnalisation du projet

Si un projet a besoin d'outils supplémentaires ou de variables d'environnement, ajoutez une petite configuration de projet au lieu de forker 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 jusqu'à ce que l'image de base ou les entrées de personnalisation changent.

Utilisez des chemins de conteneur pour les valeurs d'environnement car elles sont transmises directement au processus à l'intérieur de yolobox. Les valeurs env sont transmises au runtime telles quelles ; rien n'y 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.

Workflows courants

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 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

--claude-config synchronise de manière incrémentale les paramètres Claude durables et monte en direct le ~/.claude/projects de l'hôte en lecture/écriture afin que l'historique de reprise de session reste à jour. --no-claude-auth garde la connexion de la boîte indépendante, mais ne rend pas ce montage d'historique de projet en lecture seule.

La configuration automatique de RTK laisse la télémétrie désactivée sauf si vous l'activez de manière interactive depuis l'intérieur de la boîte avec rtk telemetry enable.

Les références détaillées se trouvent intentionnellement sur le site de documentation :

• Commands : raccourcis, commandes de maintenance, fork, et exemples
• Configuration : configuration globale, configuration de projet, instructions copiées, passthrough d'environnement, et manifestes de contexte
• Flags : chaque flag, note de compatibilité, et détail du passthrough au runtime
• Recipes : agents parallèles et routage d'applications web

Philosophie : c'est la boîte de l'IA, pas la vôtre

yolobox est conçu pour les agents IA, pas pour les humains. Vous lancez l'IA et la laissez travailler.