finbarr/yoloboxLascia che la tua IA vada a tutto gas. La tua directory home resta a casa.
██╗ ██╗ ██████╗ ██╗ ██████╗ ██████╗ ██████╗ ██╗ ██╗
╚██╗ ██╔╝██╔═══██╗██║ ██╔═══██╗██╔══██╗██╔═══██╗╚██╗██╔╝
╚████╔╝ ██║ ██║██║ ██║ ██║██████╔╝██║ ██║ ╚███╔╝
╚██╔╝ ██║ ██║██║ ██║ ██║██╔══██╗██║ ██║ ██╔██╗
██║ ╚██████╔╝███████╗╚██████╔╝██████╔╝╚██████╔╝██╔╝ ██╗
╚═╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝
Lascia che la tua AI dia il massimo. La tua home directory resta a casa.
Documentazione: yolobox.dev
Changelog: CHANGELOG.md
Esegui Claude Code, Codex, Kimi Code, Gemini, Antigravity, OpenCode, Copilot, Pi o qualsiasi agente di coding AI in "yolo mode" senza radere al suolo la tua home directory.
Gli agenti di coding AI sono incredibilmente potenti quando li lasci eseguire comandi senza chiedere il permesso. Ma basta un prompt interpretato male e, dopo un rm -rf ~, ti ritrovi a ripristinare da un backup (già, certo, come se avessi dei backup lol).
yolobox esegue il tuo agente AI all'interno di un container dove:
/Users/you/projectL'AI può scatenarsi completamente dentro la sandbox. La tua home directory reale? Intoccabile.
# 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 installa automaticamente i completamenti per bash e zsh. Per le installazioni tramite script, consulta shell completions.
Poi da qualsiasi progetto:
cd /path/to/your/project
yolobox claude # Let it rip
Anche le altre scorciatoie AI funzionano allo stesso modo:
yolobox codex
yolobox gemini
yolobox kimi
yolobox agy
yolobox antigravity
yolobox opencode
yolobox copilot
yolobox pi
Imposta default_harness = "codex" per far sì che un semplice yolobox avvii Codex. Usa yolobox shell quando vuoi una shell manuale, e yolobox run <cmd...> quando vuoi eseguire un singolo comando nella sandbox.
I dettagli completi su installazione e runtime sono disponibili in Installation & Setup. Gli esempi di comandi sono disponibili in Commands.
L'immagine base include CLI per l'IA, adattatori ACP per Codex e Claude, Node.js, Python, Go, Bun, strumenti di build, Git, GitHub CLI, ripgrep, fd, fzf, jq, vim, RTK e i soliti elementi pratici.
Ti serve qualcos'altro? L'agente ha sudo.
All'interno di yolobox, le CLI per l'IA supportate sono incapsulate per saltare le richieste di permesso. Nessuna conferma, nessuna protezione. Solo pura IA non filtrata, come madre natura intendeva.
Per un client ACP o un editor, usa yolobox run codex-acp o yolobox run claude-agent-acp come comando agente stdio. Gli adattatori includono motori compatibili e utilizzano le modalità di permesso del client; i wrapper CLI YOLO di yolobox e --no-yolo non li controllano. Le opzioni esistenti di sincronizzazione della configurazione e autenticazione si applicano. Vedi ACP clients per esempi di avvio.
L'avanzamento del pull dell'immagine e della build di immagini personalizzate viene inviato a stderr, lasciando stdout e stdin in pipe per il comando del container, anche durante l'avvio di ACP.
Per l'elenco completo degli strumenti, la tabella dei wrapper in modalità YOLO, le note su RTK, la policy di aggiornamento dei pacchetti npm e il comportamento di aggiornamento delle CLI incluse, vedi What's in the Box.
Se un progetto necessita di strumenti o variabili d'ambiente aggiuntivi, aggiungi una piccola configurazione di progetto invece di creare un fork dell'intera immagine base:
# .yolobox.toml
env = ["CODEX_HOME=/home/yolo/.codex-account"]
[customize]
packages = ["default-jdk", "maven"]
Poi eseguilo normalmente:
yolobox run mvn --version
La personalizzazione a livello di progetto può anche sovrapporre un frammento di Dockerfile all'immagine di base. La prima esecuzione costruisce un'immagine derivata; le esecuzioni successive la riutilizzano finché l'immagine di base o gli input di personalizzazione non cambiano.
Usa i percorsi del container per i valori di env perché vengono passati direttamente al processo all'interno di yolobox. I valori di env vengono passati al runtime verbatim; nulla al loro interno viene interpretato.
Per fornire alla sandbox un valore diverso da quello che l'host usa con lo stesso nome — un token di sola lettura invece di quello reale — crea un alias con env_from_host (oppure --env-from-host KEY=HOST_VAR):
# .yolobox.toml
env_from_host = ["GH_TOKEN=YOLOBOX_READONLY_GH_TOKEN"]
L'alias possiede quella variabile: sopprime il passthrough automatico e --gh-token per la stessa chiave, e yolobox rifiuta di avviarsi se la variabile host non è impostata, così il token che sostituisce non può mai trapelare per errore.
Vedi Configuration per le impostazioni env del progetto, e Project-Level Customization per l'installazione dei pacchetti, i frammenti di Dockerfile, il comportamento di rebuild, il comportamento di upgrade e le immagini completamente personalizzate.
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
L'installazione e l'aggiornamento di OpenCode consentono esplicitamente lo script postinstall npm richiesto.
--claude-config sincronizza in modo incrementale le impostazioni persistenti di Claude e monta in tempo reale ~/.claude/projects dell'host in lettura/scrittura, così la cronologia di ripresa delle sessioni resta aggiornata. --no-claude-auth mantiene il login della box indipendente, ma non rende quel mount della cronologia dei progetti in sola lettura. --copilot-config fa lo stesso per GitHub Copilot CLI: sincronizza le impostazioni persistenti di ~/.copilot, gli agenti, le skill e la configurazione MCP, inoltra il login Copilot dell'host come COPILOT_GITHUB_TOKEN e monta in tempo reale ~/.copilot/session-state in lettura/scrittura; aggiungi --no-copilot-auth per mantenere indipendente il login Copilot della box.