finbarr/yoloboxLass deine KI durchstarten. Dein Home-Verzeichnis bleibt zu Hause.
██╗ ██╗ ██████╗ ██╗ ██████╗ ██████╗ ██████╗ ██╗ ██╗ ╚██╗ ██╔╝██╔═══██╗██║ ██╔═══██╗██╔══██╗██╔═══██╗╚██╗██╔╝ ╚████╔╝ ██║ ██║██║ ██║ ██║██████╔╝██║ ██║ ╚███╔╝ ╚██╔╝ ██║ ██║██║ ██║ ██║██╔══██╗██║ ██║ ██╔██╗ ██║ ╚██████╔╝███████╗╚██████╔╝██████╔╝╚██████╔╝██╔╝ ██╗ ╚═╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝
**Lass deine KI so richtig loslegen. Dein Home-Verzeichnis bleibt zu Hause.**
Doku: [yolobox.dev](https://yolobox.dev)
Changelog: [CHANGELOG.md](https://github.com/finbarr/yolobox/blob/master/CHANGELOG.md)
Führe [Claude Code](https://claude.ai/code), [Codex](https://openai.com/codex/), [Kimi Code](https://github.com/MoonshotAI/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 du ihnen erlaubst, Befehle ohne Rückfrage auszuführen. Aber eine falsch interpretierte Eingabe und schon ist `rm -rf ~` ausgeführt und du stellst aus dem Backup wieder her (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/du/projekt`
- der Agent volle Berechtigungen und sudo innerhalb des Containers hat
- 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 eine integrierte yolobox-Anleitung, damit sie die Sandbox verstehen, in der sie laufen
Die KI kann in der Sandbox völlig wild werden. Dein echtes Home-Verzeichnis? Unantastbar.
## Schnellstart
```bash
# Installation über Homebrew
brew install finbarr/tap/yolobox
# Oder Installation per Skript
curl -fsSL https://raw.githubusercontent.com/finbarr/yolobox/master/install.sh | bash
Dann aus einem beliebigen Projekt:
cd /pfad/zu/deinem/projekt
yolobox claude # Lass es laufen
Andere KI-Verknüpfungen funktionieren genauso:
yolobox codex
yolobox gemini
yolobox kimi
yolobox agy
yolobox antigravity
yolobox opencode
yolobox copilot
yolobox pi
Setze default_harness = "codex", damit ein nacktes yolobox Codex startet. Verwende yolobox shell, wenn du eine manuelle Shell möchtest, und yolobox run <befehl...>, 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 Befehle.
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 Werkzeuge.
Du brauchst etwas anderes? Der Agent hat sudo.
Innerhalb von yolobox werden unterstützte KI-CLIs so umschlossen, dass Berechtigungsabfragen übersprungen werden. Keine Bestätigungen, keine Leitplanken. Nur pure, ungefilterte KI, wie es die Natur vorgesehen hat.
Für die vollständige Werkzeugliste, die Tabelle der YOLO-Modus-Wrapper, RTK-Hinweise, die Richtlinie zur Aktualität von npm-Paketen und das Upgrade-Verhalten der gebündelten CLIs siehe Was ist in der 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
Die Anpassung auf Projektebene kann auch ein Dockerfile-Fragment auf das Basis-Image aufsetzen. 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 einen anderen Wert zu übergeben als der Host unter demselben Namen verwendet – 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, sodass das ersetzte Token niemals versehentlich durchsickern kann.
Siehe Konfiguration für Projekt-env-Einstellungen und Anpassung auf Projektebene für Paketinstallationen, Dockerfile-Fragmente, Rebuild-Verhalten, Upgrade-Verhalten und vollständig benutzerdefinierte Images.
yolobox setup # Globale Standardwerte konfigurieren
yolobox config # Aufgelöste Konfiguration für dieses Projekt anzeigen
yolobox claude --docker --gh-token # Dem Agenten Docker- und GitHub-Zugriff geben
yolobox claude --claude-config --no-claude-auth # Konfiguration teilen, Box-Login unabhängig halten
yolobox codex --rtk # RTK-Komprimierung der Befehlsausgabe aktivieren
yolobox run --no-network make test # Einen Befehl ohne Netzwerk ausführen
yolobox fork --name bruno codex # Einem Agenten eine eigene Projektkopie geben
yolobox upgrade # Binärdatei aktualisieren und neuestes Image ziehen
yolobox update-agents # KI-CLIs in der persistenten Box aktualisieren
--claude-config synchronisiert dauerhafte Claude-Einstellungen inkrementell und mountet das Host-~/.claude/projects live mit Lese-/Schreibzugriff, sodass der Sitzungsverlauf aktuell bleibt. --no-claude-auth hält das Box-Login unabhängig, macht diesen Projektverlaufs-Mount jedoch nicht schreibgeschützt.
Die automatische RTK-Einrichtung lässt Telemetrie deaktiviert, es sei denn, du stimmst interaktiv von innerhalb der Box mit rtk telemetry enable zu.
Die detaillierten Referenzen befinden sich bewusst auf der Doku-Website:
fork und Beispieleyolobox 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 bewahren diese Einrichtung über Sitzungen hinweg, sodass du die README nicht in eine hundertzeilige Paketmatrix verwandeln musst. Richte ihn auf dein Projekt aus und lass ihn kochen.
yolobox ist Schutz vor Unfällen, kein magisches Theorem gegen Container-Escapes.
Es hilft, dein Home-Verzeichnis, SSH-Schlüssel, Dotfiles, unzusammenhängende Projekte und den meisten Zustand des Host-Dateisystems vor unachtsamen destruktiven Befehlen zu schützen. Es schützt nicht das Projektverzeichnis, das du eingehängt hast, Geheimnisse, die du ausdrücklich weiterleitest, Host-Aktionen, die du ausdrücklich überbrückst, oder den Host-Kernel vor Laufzeit-Escape-Schwachstellen.
Für eine engere Box kombiniere Flags wie:
yolobox claude --no-network --no-env-passthrough --readonly-project --exclude ".env*" --exclude "secrets/**"
Wenn du dir Sorgen um feindseligen Code machst und nicht nur um unachtsamen, verwende stärkere Isolation wie rootless Podman oder eine VM. Das vollständige Bedrohungsmodell und die Härtungsoptionen findest du unter Sicherheitsmodell.
make build
make test
make lint
make image
Der Workflow für Mitwirkende, Doku-Website-Befehle, Versionierung und Release-Regeln findest du unter Mitwirken.
MIT