yolobox v0.19.4

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

Lass deine KI voll aufdrehen. Dein Home-Verzeichnis bleibt zu Hause.

Docs: yolobox.dev

Changelog: CHANGELOG.md

Führe Claude Code, Codex, Kimi Code, Gemini, Antigravity, OpenCode, Copilot, Pi oder jeden anderen KI-Coding-Agenten im "YOLO-Modus" aus, ohne dein Home-Verzeichnis zu zerstören.

Das Problem

KI-Coding-Agenten sind unglaublich mächtig, wenn man sie Befehle ohne Rückfrage ausführen lässt. Aber ein falsch interpretierter Prompt und ein rm -rf ~ später stellst du aus dem Backup wieder her (ja klar, als ob du Backups hättest lol).

Die Lösung

yolobox führt deinen KI-Agenten in einem Container aus, in dem:

• dein Projektverzeichnis unter seinem echten Pfad eingebunden wird, z. B. /Users/you/project
• der Agent volle Berechtigungen und sudo innerhalb des Containers hat
• dein Home-Verzeichnis nicht eingebunden wird, es sei denn, du stimmst dem ausdrücklich zu
• persistente Volumes Tools, Konfigurationen und Sitzungen über mehrere Läufe hinweg erhalten
• Claude, Codex und Kimi Code eine integrierte yolobox-Anleitung erhalten, damit sie die Sandbox verstehen, in der sie laufen

Die KI kann innerhalb der Sandbox völlig durchdrehen. Dein tatsächliches Home-Verzeichnis? Unantastbar.

Schnellstart

# Install via Homebrew
brew install finbarr/tap/yolobox

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

Dann aus jedem Projekt heraus:

cd /path/to/your/project
yolobox claude    # Let it rip

Andere KI-Shortcuts funktionieren genauso:

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

Vollständige Installations- und Laufzeitdetails findest du unter Installation & Setup. Befehlsbeispiele findest du unter Commands.

Was ist enthalten?

Das Basis-Image enthält KI-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 sind unterstützte KI-CLIs so umhüllt, dass Berechtigungsabfragen übersprungen werden. Keine Bestätigungen, keine Schutzgeländer. Nur pure 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 YOLO-Wrapper der yolobox-CLI und --no-yolo steuern sie nicht. Bestehende Konfigurationssynchronisierung und Authentifizierungsoptionen gelten weiterhin. Siehe ACP clients für Startbeispiele.

Für die vollständige Tool-Liste, die YOLO-Modus-Wrapper-Tabelle, RTK-Hinweise, die Aktualitätsrichtlinie für npm-Pakete und das Upgrade-Verhalten gebündelter CLIs siehe What's in the Box.

Projektanpassung

Wenn ein Projekt zusätzliche Tools 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

Projektbezogene Anpassung kann 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 Laufzeit ü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 statt 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"]

Der Alias besitzt diese Variable: Er unterdrückt die automatische Weitergabe und --gh-token für denselben Schlüssel, und yolobox weigert sich zu starten, wenn die Host-Variable nicht gesetzt ist, sodass das ersetzte Token niemals versehentlich durchsickern kann.

Siehe Configuration für Projekt-Env-Einstellungen und Project-Level Customization für Paketinstallationen, Dockerfile-Fragmente, Rebuild-Verhalten, Upgrade-Verhalten und vollständig benutzerdefinierte Images.

Häufige Workflows

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 synchronisiert dauerhafte Claude-Einstellungen inkrementell und bindet das Host-Verzeichnis ~/.claude/projects live mit Lese-/Schreibzugriff ein, damit die Sitzungswiederaufnahme-Historie aktuell bleibt. --no-claude-auth hält die Box-Anmeldung unabhängig, macht aber diesen Projektverlaufs-Mount nicht schreibgeschützt.

Die automatische RTK-Einrichtung lässt Telemetrie deaktiviert, sofern du nicht interaktiv von innerhalb der Box mit rtk telemetry enable zustimmst.

Die detaillierten Referenzen befinden sich bewusst auf der Docs-Website:

• Commands: Shortcuts, Wartungsbefehle, fork und Beispiele
• Configuration: globale Konfiguration, Projektkonfiguration, kopierte Anweisungen, Env-Weitergabe und Kontext-Manifeste
• Flags: jeder Flag, Kompatibilitätshinweis und Laufzeit-Weitergabedetail
• Recipes: parallele Agenten und Webapp-Routing

Philosophie: Es ist die Box der KI, nicht deine

yolobox ist für KI-Agenten konzipiert, nicht für Menschen. Du startest die KI und lässt sie arbeiten.

Der Agent hat sudo innerhalb des Containers. Wenn er einen Compiler, eine Datenbank, ein Paket oder ein Framework benötigt, kann er eines installieren. Benannte Volumes erhalten dieses Setup über Sitzungen hinweg, sodass du die README nicht in eine hundertzeilige Paketmatrix verwandeln musst. Richte ihn auf dein Projekt und lass ihn kochen.

Sicherheitsmodell

yolobox ist Schutz vor Unfällen, kein magisches Anti-Container-Escape-Theorem.