yolobox v0.19.4

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

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 distruggere la tua home directory.

Il Problema

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 (sì, certo, come se avessi dei backup lol).

La Soluzione

yolobox esegue il tuo agente AI all'interno di un container dove:

• la directory del tuo progetto è montata al suo percorso reale, ad esempio /Users/you/project
• l'agente ha permessi completi e sudo all'interno del container
• la tua home directory non è montata a meno che tu non lo richieda esplicitamente
• volumi persistenti mantengono strumenti, configurazioni e sessioni tra un'esecuzione e l'altra
• Claude, Codex e Kimi Code ricevono una guida integrata di yolobox così possono capire il sandbox in cui stanno girando

L'AI può scatenarsi completamente dentro il sandbox. La tua home directory reale? Intoccabile.

Avvio Rapido

# Install via Homebrew
brew install finbarr/tap/yolobox

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

Poi da qualsiasi progetto:

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

Le altre scorciatoie per 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 il semplice comando yolobox avvii Codex. Usa yolobox shell quando vuoi una shell manuale, e yolobox run <cmd...> quando vuoi eseguire un singolo comando nel sandbox.

I dettagli completi su installazione e runtime sono in Installation & Setup. Gli esempi di comandi sono in Commands.

Cosa c'è dentro?

L'immagine base include le CLI per AI, gli adattatori ACP di Codex e Claude, Node.js, Python, Go, Bun, strumenti di build, Git, GitHub CLI, ripgrep, fd, fzf, jq, vim, RTK e i soliti strumenti pratici.

Ti serve altro? L'agente ha sudo.

Dentro yolobox, le CLI AI supportate sono wrappate per saltare le richieste di permesso. Nessuna conferma, nessuna barriera di sicurezza. Solo pura AI non filtrata, come madre natura comanda.

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 engine compatibili e usano le modalità di permesso del client; i wrapper CLI YOLO di yolobox e --no-yolo non li controllano. Si applicano le opzioni esistenti di sincronizzazione della configurazione e autenticazione. Vedi ACP clients per esempi di avvio.

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.

Personalizzazione del Progetto

Se un progetto necessita di strumenti o variabili d'ambiente aggiuntive, aggiungi una piccola configurazione di progetto invece di fare il fork dell'intera immagine base:

# .yolobox.toml
env = ["CODEX_HOME=/home/yolo/.codex-account"]

[customize]
packages = ["default-jdk", "maven"]

Poi esegui normalmente:

yolobox run mvn --version

La personalizzazione a livello di progetto può anche sovrapporre un frammento di Dockerfile all'immagine base. La prima esecuzione costruisce un'immagine derivata; le esecuzioni successive la riutilizzano finché l'immagine base o gli input di personalizzazione non cambiano.

Usa percorsi del container per i valori di env, perché vengono passati direttamente al processo dentro yolobox. I valori di env vengono passati al runtime così come sono; nulla in essi viene interpretato.

Per fornire al 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 (o --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 di progetto, e Project-Level Customization per installazioni di pacchetti, frammenti di Dockerfile, comportamento di rebuild, comportamento di aggiornamento e immagini completamente personalizzate.

Workflow Comuni

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 sincronizza in modo incrementale le impostazioni durevoli 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 indipendente il login del box, ma non rende quel mount della cronologia di progetto in sola lettura.

La configurazione automatica di RTK lascia la telemetria disabilitata a meno che tu non faccia opt-in interattivamente dall'interno del box con rtk telemetry enable.

I riferimenti dettagliati sono intenzionalmente nel sito di documentazione:

• Commands: scorciatoie, comandi di manutenzione, fork ed esempi
• Configuration: configurazione globale, configurazione di progetto, istruzioni copiate, passthrough env e manifest di contesto
• Flags: ogni flag, nota di compatibilità e dettaglio sul passthrough a runtime
• Recipes: agenti in parallelo e routing di webapp

Filosofia: È il Box dell'AI, Non il Tuo

yolobox è progettato per agenti AI, non per umani. Tu avvii l'AI e la lasci lavorare.

L'agente ha sudo all'interno del container. Se gli serve un compilatore, un database, un pacchetto o un framework, può installarlo. I volumi con nome preservano quella configurazione tra le sessioni, così non devi trasformare il README in una matrice di pacchetti da cento righe. Puntalo al tuo progetto e lascialo cucinare.

Modello di Sicurezza

yolobox è una protezione dagli incidenti, non un teorema magico anti-container-escape.