
Lass deine KI durchstarten. Dein Home-Verzeichnis bleibt zu Hause.
██╗ ██╗ ██████╗ ██╗ ██████╗ ██████╗ ██████╗ ██╗ ██╗
╚██╗ ██╔╝██╔═══██╗██║ ██╔═══██╗██╔══██╗██╔═══██╗╚██╗██╔╝
╚████╔╝ ██║ ██║██║ ██║ ██║██████╔╝██║ ██║ ╚███╔╝
╚██╔╝ ██║ ██║██║ ██║ ██║██╔══██╗██║ ██║ ██╔██╗
██║ ╚██████╔╝███████╗╚██████╔╝██████╔╝╚██████╔╝██╔╝ ██╗
╚═╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝
Lass deine KI voll aufdrehen. Dein Home-Verzeichnis bleibt, was es ist.
Doku: yolobox.dev
Changelog: CHANGELOG.md
Führe Claude Code, Codex, Kimi Code, Gemini, Antigravity, OpenCode, Copilot, Pi oder einen beliebigen KI-Coding-Agenten im „Yolo-Modus" aus, ohne dein Home-Verzeichnis zu zerstören.
KI-Coding-Agenten sind unglaublich leistungsfähig, wenn man sie Befehle ohne Nachfrage ausführen lässt. Aber nach einem falsch interpretierten Prompt und einem rm -rf ~ später stellst du gerade aus dem Backup wieder her (ja klar, als ob du Backups hättest, lol).
yolobox führt deinen KI-Agenten in einem Container aus, in dem:
/Users/you/projectDie KI kann innerhalb der Sandbox völlig durchdrehen. Dein tatsächliches Home-Verzeichnis? Unantastbar.
# 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 installiert bash- und zsh-Completions automatisch. Für Skript-Installationen siehe shell completions.
Dann aus jedem Projekt:
cd /path/to/your/project
yolobox claude # Let it rip
Andere KI-Shortcuts funktionieren auf die gleiche Weise:
yolobox codex
yolobox gemini
yolobox kimi
yolobox agy
yolobox antigravity
yolobox opencode
yolobox copilot
yolobox pi
Setze default_harness = "codex", damit ein bloßes yolobox Codex startet. Verwende yolobox shell, wenn du eine manuelle Shell möchtest, und yolobox run <cmd...>, wenn du einen einzelnen Befehl in der Sandbox ausführen möchtest.
Vollständige Installations- und Laufzeitdetails findest du unter Installation & Setup. Befehlsbeispiele findest du unter Commands.
Das Basis-Image enthält AI-CLIs, Codex- und Claude-ACP-Adapter, Node.js, Python, Go, Bun, Build-Tools, Git, GitHub CLI, ripgrep, fd, fzf, jq, vim, RTK und die üblichen praktischen Dinge.
Brauchst du etwas anderes? Der Agent hat sudo.
Innerhalb von yolobox werden unterstützte AI-CLIs umhüllt, um Berechtigungsabfragen zu überspringen. Keine Bestätigungen, keine Schutzmechanismen. Nur reine, ungefilterte KI, so wie die Natur es vorgesehen hat.
Für einen ACP-Client oder Editor verwende yolobox run codex-acp oder yolobox run claude-agent-acp als dessen stdio-Agent-Befehl. Die Adapter bündeln kompatible Engines und verwenden die Berechtigungsmodi des Clients; die CLI-YOLO-Wrapper von yolobox und --no-yolo steuern sie nicht. Die bestehenden Konfigurationssynchronisierungs- und Authentifizierungsoptionen gelten. Siehe ACP clients für Startbeispiele.
Der Fortschritt beim Image-Pull und beim Build benutzerdefinierter Images wird nach stderr ausgegeben, sodass stdout und gepiptes stdin für den Container-Befehl frei bleiben, auch während des ACP-Starts.
Die vollständige Werkzeugliste, die YOLO-Modus-Wrapper-Tabelle, RTK-Hinweise, die Richtlinie zur Aktualität von npm-Paketen und das Upgrade-Verhalten der gebündelten CLIs findest du unter What's in the Box.
Wenn ein Projekt zusätzliche Werkzeuge oder Umgebungsvariablen benötigt, füge eine kleine Projektkonfiguration hinzu, anstatt das gesamte Basis-Image zu forken:
# .yolobox.toml
env = ["CODEX_HOME=/home/yolo/.codex-account"]
[customize]
packages = ["default-jdk", "maven"]
Dann normal ausführen:
yolobox run mvn --version
Projektweite Anpassungen können auch ein Dockerfile-Fragment auf das Basis-Image aufschichten. Der erste Lauf baut ein abgeleitetes Image; spätere Läufe verwenden es wieder, bis sich das Basis-Image oder die Anpassungseingaben ändern.
Verwende Container-Pfade für env-Werte, da sie direkt an den Prozess innerhalb von yolobox übergeben werden. env-Werte werden unverändert an die Laufzeitumgebung übergeben; nichts darin wird interpretiert.
Um der Sandbox einen anderen Wert als den des Hosts unter demselben Namen zu übergeben — etwa ein schreibgeschütztes Token anstelle deines echten —, verknüpfe ihn mit env_from_host (oder --env-from-host KEY=HOST_VAR):
# .yolobox.toml
env_from_host = ["GH_TOKEN=YOLOBOX_READONLY_GH_TOKEN"]
Das Alias besitzt diese Variable: Es unterdrückt die automatische Weitergabe und --gh-token für denselben Schlüssel, und yolobox verweigert den Start, wenn die Host-Variable nicht gesetzt ist, sodass das Token, das es ersetzt, niemals versehentlich durchsickern kann.
Siehe Configuration für Projekteinstellungen zur Umgebung und Project-Level Customization für Paketinstallationen, Dockerfile-Fragmente, Rebuild-Verhalten, Upgrade-Verhalten und vollständig benutzerdefinierte Images.
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
yolobox reset --force # Remove yolobox volumes from the configured runtime
Reset funktioniert mit Docker, Podman und Apple container. Es entfernt nur vorhandene yolobox-Volumes und ist erfolgreich, wenn keine mehr übrig sind. yolobox uninstall --force bereinigt diese Volumes ebenfalls, bevor die Binärdatei und die globale Konfiguration entfernt werden; ein Laufzeitfehler bricht die Deinstallation ab, sodass sie erneut versucht werden kann. Fügen Sie --keep-volumes zur Deinstallation hinzu, um die Laufzeitdaten zu erhalten.
Das Image enthält OpenCode v2 (@opencode/cli). yolobox update-agents opencode installiert ebenfalls v2 und entfernt zuvor das alte Paket opencode-ai aus dem persistenten npm-Prefix, um einen Launcher-Konflikt zu vermeiden. Installationen erlauben ausdrücklich das erforderliche postinstall-Skript. Vorhandene, vom Benutzer installierte v1-Kopien bleiben bestehen, bis Sie sie aktualisieren; das alleinige Ziehen eines neuen Images ersetzt keine persistenten Tools.