Zurück zu den Updates
New releaseAug 17, 2026

yolobox v0.19.0

Lass deine KI durchstarten. Dein Home-Verzeichnis bleibt zu Hause.

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

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.

Das Problem

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

Die Lösung

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

  • dein Projektverzeichnis unter seinem echten Pfad eingebunden ist, etwa /Users/you/project
  • der Agent innerhalb des Containers volle Berechtigungen und sudo hat
  • dein Home-Verzeichnis nicht eingebunden ist, 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

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.

Was ist enthalten?

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.

Projektanpassung

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.

Häufige Arbeitsabläufe

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.

Kategorien