yolobox

Ensuite, depuis n'importe quel projet :

Les autres raccourcis IA fonctionnent de la même manière :

Définissez default_harness = "codex" pour que yolobox nu lance Codex. Utilisez yolobox shell lorsque vous voulez un shell manuel, et yolobox run <cmd...> lorsque vous voulez une seule commande dans le bac à sable.

Les détails complets d'installation et d'exécution se trouvent dans Installation et Configuration. Les exemples de commandes se trouvent dans Commandes.

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

L'image de base comprend les CLI IA, 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 a sudo.

Dans yolobox, les CLI IA pris en charge sont enveloppées pour ignorer les invites de permission. Pas de confirmations, pas de garde-fous. Juste de l'IA pure et non filtrée, comme la nature l'a prévu.

Pour la liste complète des outils, le tableau des enveloppes en mode YOLO, les notes RTK, la politique de fraîcheur des packages npm, et le comportement de mise à niveau des CLI inclus, voir Qu'y a-t-il dans la Boîte.

Personnalisation du Projet

Si un projet nécessite des outils ou des variables d'environnement supplémentaires, ajoutez une petite configuration de projet au lieu de dupliquer toute l'image de base :

Puis exécutez normalement :

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 dans yolobox. Les valeurs env sont transmises à l'exécution telles quelles ; rien en elles n'est interprété.

Pour donner au bac à sable une valeur différente de celle que l'hôte utilise sous le même nom — un jeton en lecture seule au lieu de votre vrai jeton — aliassez-la avec env_from_host (ou --env-from-host KEY=HOST_VAR) :

L'alias possède cette variable : il supprime le transfert 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 fuir par accident.

Voir Configuration pour les paramètres d'environnement du projet, et Personnalisation au Niveau du Projet pour les installations de packages, les fragments de Dockerfile, le comportement de reconstruction, le comportement de mise à niveau, et les images entièrement personnalisées.

Flux de Travail Courants

--claude-config synchronise de manière incrémentale les paramètres durables de Claude et monte en direct le répertoire hôte ~/.claude/projects en lecture/écriture afin que l'historique de reprise de session reste à jour. --no-claude-auth maintient 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 y consentez 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 :

• Commandes : raccourcis, commandes de maintenance, fork, et exemples
• Configuration : configuration globale, configuration de projet, instructions copiées, transfert d'environnement, et manifestes de contexte
• Drapeaux : chaque drapeau, note de compatibilité, et détail de transfert à l'exécution
• Recettes : 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.

L'agent a sudo dans le conteneur. S'il a besoin d'un compilateur, d'une base de données, d'un package ou d'un framework, il peut en installer un. Les volumes nommés préservent cette configuration entre les sessions, de sorte que vous n'avez pas à transformer le README en une matrice de packages de cent lignes. Pointez-le vers votre projet et laissez-le cuisiner.

Modèle de Sécurité

yolobox est une protection contre les accidents, pas un théorème magique anti-évasion de conteneur.

Il aide à protéger votre répertoire personnel, vos clés SSH, vos dotfiles, vos projets non liés, et la plupart de l'état du système de fichiers hôte contre les commandes destructrices négligentes. Il ne protège pas le répertoire de projet que vous avez monté, les secrets que vous transférez explicitement, les actions hôte que vous pontiez explicitement, ni le noyau hôte contre les vulnérabilités d'évasion à l'exécution.

Pour une boîte plus stricte, combinez des drapeaux tels que :

Si vous craignez un code hostile plutôt qu'un code négligent, utilisez une isolation plus forte comme Podman sans racine ou une VM. Le modèle de menace complet et les options de durcissement se trouvent dans Modèle de Sécurité.

Développement

Le flux de travail des contributeurs, les commandes du site de documentation, le versionnage et les règles de publication se trouvent dans Contribuer.

Licence

MIT