yolobox

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

Lass deine KI so richtig durchstarten. Dein Home-Verzeichnis bleibt unangetastet.

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

Das Problem

KI-Coding-Agenten sind unglaublich mächtig, wenn man sie Befehle ausführen lässt, ohne um Erlaubnis zu fragen. Doch eine falsch interpretierte Eingabe und schon steht rm -rf ~ im Raum – und du stellst 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 eingehängt ist, z. B. /Users/you/project
• der Agent im Container volle Rechte und sudo besitzt
• dein Home-Verzeichnis nicht eingehängt ist, außer du stimmst ausdrücklich zu
• persistente Volumes Tools, Konfigurationen und Sitzungen über mehrere Läufe hinweg erhalten
• Claude, Codex und Kimi Code erhalten integrierte yolobox-Hinweise, damit sie die Sandbox verstehen, in der sie laufen

Die KI kann in der Sandbox völlig durchdrehen. Dein echtes 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 einem beliebigen Projekt:

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

Andere KI-Kurzbefehle 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 möchtest.

Ausführliche Installations- und Laufzeitdetails findest du unter Installation & Setup. Beispiele für Befehle findest du unter Befehle.

Was steckt in der Box?

Das Basis-Image enthält KI-CLIs, Node.js, Python, Go, Bun, Build-Tools, Git, GitHub CLI, ripgrep, fd, fzf, jq, vim, RTK und die üblichen praktischen Dinge.

Du brauchst noch etwas? Der Agent hat sudo.

In yolobox werden unterstützte KI-CLIs umhüllt, sodass sie keine Berechtigungsabfragen anzeigen. Keine Bestätigungen, keine Schutzmaßnahmen. Nur pure, ungefilterte KI, wie es die Natur vorgesehen hat.

Die vollständige Tool-Liste, die Tabelle der YOLO-Modus-Wrapper, RTK-Hinweise, die Richtlinie zur Aktualität von npm-Paketen und das Upgrade-Verhalten der gebündelten CLIs findest du unter Was steckt in der 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 ganz normal ausführen:

yolobox run mvn --version

Projektanpassungen können außerdem ein Dockerfile-Fragment auf das Basis-Image aufbringen. Der erste Lauf erstellt ein abgeleitetes Image; spätere Läufe verwenden es erneut, 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 unter demselben Namen einen anderen Wert zu übergeben als der Host verwendet – z. B. ein schreibgeschütztes Token statt deines echten – aliasiere 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 Durchreichung und --gh-token für denselben Schlüssel, und yolobox weigert sich zu starten, wenn die Host-Variable nicht gesetzt ist. So kann das ersetzte Token niemals versehentlich durchsickern.

Weitere Informationen zu Projekt-Umgebungseinstellungen findest du unter Konfiguration und zu Paketinstallationen, Dockerfile-Fragmenten, Rebuild-Verhalten, Upgrade-Verhalten und vollständig individuellen Images unter Projektanpassung.

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 in the persistent box

Die ausführlichen Referenzen befinden sich bewusst auf der Doku-Website:

• Befehle: Kurzbefehle, Wartungsbefehle, fork und Beispiele
• Konfiguration: globale Konfiguration, Projektkonfiguration, kopierte Anweisungen, env-Durchreichung und Kontext-Manifeste
• Flags: jedes Flag, Kompatibilitätshinweise und Details zur Laufzeit-Durchreichung
• Rezepte: 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 im Container. Wenn er einen Compiler, eine Datenbank, ein Paket oder ein Framework benötigt, kann er es installieren. Benannte Volumes erhalten diese Einrichtung über Sitzungen hinweg, sodass du das README nicht in eine hundertzeilige Paketmatrix verwandeln musst. Richte es auf dein Projekt aus und lass es kochen.

Sicherheitsmodell

yolobox schützt vor Unfällen, ist aber kein magisches Anti-Container-Escape-Theorem.

Es schützt dein Home-Verzeichnis, SSH-Schlüssel, Dotfiles, nicht verwandte Projekte und den Großteil des Host-Dateisystemzustands vor unvorsichtigen destruktiven Befehlen. Es schützt nicht das von dir eingehängte Projektverzeichnis, explizit weitergeleitete Geheimnisse, explizit überbrückte Host-Aktionen oder den Host-Kernel vor Laufzeit-Escape-Schwachstellen.

Für eine strengere Box kannst du Flags kombinieren, z. B.:

yolobox claude --no-network --no-env-passthrough --readonly-project --exclude ".env*" --exclude "secrets/**"

Wenn du dir eher um feindseligen Code sorgst als um unvorsichtigen, verwende eine stärkere Isolation wie rootless Podman oder eine VM. Das vollständige Bedrohungsmodell und Härtungsoptionen findest du unter Sicherheitsmodell.

Entwicklung

make build
make test
make lint
make image

Der Workflow für Mitwirkende, Doku-Site-Befehle, Versionierung und Release-Regeln findest du unter Mitwirken.

Lizenz

MIT