yolobox v0.19.4

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

अपने AI को पूरी छूट दें। आपकी होम डायरेक्टरी सुरक्षित रहेगी।

डॉक्स: yolobox.dev

चेंजलॉग: CHANGELOG.md

Claude Code, Codex, Kimi Code, Gemini, Antigravity, OpenCode, Copilot, Pi, या किसी भी AI कोडिंग एजेंट को "yolo मोड" में चलाएँ, बिना अपनी होम डायरेक्टरी उड़ाए।

समस्या

AI कोडिंग एजेंट तब बेहद शक्तिशाली होते हैं जब आप उन्हें बिना अनुमति माँगे कमांड चलाने देते हैं। लेकिन एक गलत समझे गए प्रॉम्प्ट और rm -rf ~ के बाद, आप बैकअप से रीस्टोर कर रहे होते हैं (हाँ ठीक है, जैसे आपके पास बैकअप हैं ही lol)।

समाधान

yolobox आपके AI एजेंट को एक कंटेनर के अंदर चलाता है जहाँ:

• आपकी प्रोजेक्ट डायरेक्टरी अपने असली पाथ पर माउंट होती है, जैसे /Users/you/project
• एजेंट के पास कंटेनर के अंदर पूरी अनुमतियाँ और sudo होता है
• आपकी होम डायरेक्टरी तब तक माउंट नहीं होती जब तक आप स्पष्ट रूप से ऑप्ट-इन न करें
• पर्सिस्टेंट वॉल्यूम्स टूल्स, कॉन्फ़िग्स और सेशन्स को रन्स के बीच बनाए रखते हैं
• Claude, Codex, और Kimi Code को बिल्ट-इन yolobox गाइडेंस मिलती है ताकि वे समझ सकें कि वे किस सैंडबॉक्स में चल रहे हैं

AI सैंडबॉक्स के अंदर बिल्कुल बेकाबू हो सकता है। आपकी असली होम डायरेक्टरी? अछूती।

त्वरित शुरुआत

# Install via Homebrew
brew install finbarr/tap/yolobox

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

फिर किसी भी प्रोजेक्ट से:

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

अन्य AI शॉर्टकट्स भी इसी तरह काम करते हैं:

yolobox codex
yolobox gemini
yolobox kimi
yolobox agy
yolobox antigravity
yolobox opencode
yolobox copilot
yolobox pi

default_harness = "codex" सेट करें ताकि केवल yolobox चलाने पर Codex लॉन्च हो। जब आपको मैन्युअल शेल चाहिए तो yolobox shell का उपयोग करें, और जब आपको सैंडबॉक्स में एक कमांड चलाना हो तो yolobox run <cmd...> का उपयोग करें।

पूर्ण इंस्टॉल और रनटाइम विवरण Installation & Setup में हैं। कमांड उदाहरण Commands में हैं।

बॉक्स में क्या है?

बेस इमेज में AI CLIs, Codex और Claude ACP अडैप्टर्स, Node.js, Python, Go, Bun, बिल्ड टूल्स, Git, GitHub CLI, ripgrep, fd, fzf, jq, vim, RTK, और आम उपयोगी चीज़ें शामिल हैं।

कुछ और चाहिए? एजेंट के पास sudo है।

yolobox के अंदर, समर्थित AI CLIs को परमिशन प्रॉम्प्ट्स स्किप करने के लिए रैप किया जाता है। कोई पुष्टि नहीं, कोई गार्डरेल नहीं। बस शुद्ध अनफ़िल्टर्ड AI, जैसा प्रकृति ने चाहा था।

ACP क्लाइंट या एडिटर के लिए, yolobox run codex-acp या yolobox run claude-agent-acp को उसके stdio एजेंट कमांड के रूप में उपयोग करें। अडैप्टर्स संगत इंजन बंडल करते हैं और क्लाइंट के परमिशन मोड्स का उपयोग करते हैं; yolobox के CLI YOLO रैपर्स और --no-yolo उन्हें नियंत्रित नहीं करते। मौजूदा कॉन्फ़िग सिंक और ऑथेंटिकेशन विकल्प लागू होते हैं। लॉन्च उदाहरणों के लिए ACP clients देखें।

पूरी टूल सूची, YOLO-मोड रैपर टेबल, RTK नोट्स, npm पैकेज फ्रेशनेस पॉलिसी, और बंडल्ड CLI अपग्रेड व्यवहार के लिए, What's in the Box देखें।

प्रोजेक्ट कस्टमाइज़ेशन

अगर किसी एक प्रोजेक्ट को अतिरिक्त टूल्स या एनवायरनमेंट वेरिएबल्स चाहिए, तो पूरी बेस इमेज को फोर्क करने के बजाय एक छोटा प्रोजेक्ट कॉन्फ़िग जोड़ें:

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

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

फिर सामान्य रूप से चलाएँ:

yolobox run mvn --version

प्रोजेक्ट-स्तरीय कस्टमाइज़ेशन बेस इमेज के ऊपर एक Dockerfile फ्रैगमेंट भी लेयर कर सकता है। पहला रन एक डेराइव्ड इमेज बनाता है; बाद के रन्स इसे तब तक रीयूज़ करते हैं जब तक बेस इमेज या कस्टमाइज़ेशन इनपुट्स न बदलें।

env वैल्यूज़ के लिए कंटेनर पाथ्स का उपयोग करें क्योंकि वे सीधे yolobox के अंदर प्रोसेस को पास किए जाते हैं। env वैल्यूज़ रनटाइम को वर्बेटिम पास की जाती हैं; उनमें कुछ भी इंटरप्रेट नहीं किया जाता।

सैंडबॉक्स को उसी नाम के तहत होस्ट द्वारा उपयोग किए जाने वाले मान से अलग मान देने के लिए — आपके असली टोकन के बजाय एक रीड-ओनली टोकन — इसे env_from_host (या --env-from-host KEY=HOST_VAR) से अलियास करें:

# .yolobox.toml
env_from_host = ["GH_TOKEN=YOLOBOX_READONLY_GH_TOKEN"]

अलियास उस वेरिएबल का मालिक होता है: यह उसी की के लिए ऑटोमैटिक पासथ्रू और --gh-token को दबा देता है, और अगर होस्ट वेरिएबल सेट नहीं है तो yolobox शुरू होने से मना कर देता है, ताकि जिस टोकन को यह बदलता है वह गलती से कभी लीक न हो सके।

प्रोजेक्ट env सेटिंग्स के लिए Configuration देखें, और पैकेज इंस्टॉल्स, Dockerfile फ्रैगमेंट्स, रीबिल्ड व्यवहार, अपग्रेड व्यवहार, और पूरी तरह कस्टम इमेजेज़ के लिए Project-Level Customization देखें।

सामान्य वर्कफ़्लोज़

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 टिकाऊ Claude सेटिंग्स को इंक्रीमेंटली सिंक करता है और होस्ट ~/.claude/projects को रीड/राइट लाइव-माउंट करता है ताकि सेशन रिज़्यूम इतिहास अप-टू-डेट रहे। --no-claude-auth बॉक्स लॉगिन को स्वतंत्र रखता है, लेकिन उस प्रोजेक्ट-हिस्ट्री माउंट को रीड-ओनली नहीं बनाता।

ऑटोमैटिक RTK सेटअप टेलीमेट्री को डिसेबल्ड छोड़ता है जब तक आप बॉक्स के अंदर से इंटरैक्टिव रूप से rtk telemetry enable के साथ ऑप्ट-इन न करें।

विस्तृत संदर्भ जानबूझकर डॉक्स साइट पर हैं:

• Commands: शॉर्टकट्स, मेंटेनेंस कमांड्स, fork, और उदाहरण
• Configuration: ग्लोबल कॉन्फ़िग, प्रोजेक्ट कॉन्फ़िग, कॉपी किए गए निर्देश, env पासथ्रू, और कॉन्टेक्स्ट मैनिफ़ेस्ट्स
• Flags: हर फ्लैग, कम्पैटिबिलिटी नोट, और रनटाइम पासथ्रू विवरण
• Recipes: पैरेलल एजेंट्स और वेबऐप रूटिंग

दर्शन: यह AI का बॉक्स है, आपका नहीं

yolobox AI एजेंट्स के लिए डिज़ाइन किया गया है, इंसानों के लिए नहीं। आप AI लॉन्च करते हैं और उसे काम करने देते हैं।

एजेंट के पास कंटेनर के अंदर sudo है। अगर उसे कंपाइलर, डेटाबेस, पैकेज, या फ्रेमवर्क चाहिए, तो वह इंस्टॉल कर सकता है। नेम्ड वॉल्यूम्स उस सेटअप को सेशन्स के बीच बनाए रखते हैं, ताकि आपको README को सौ-लाइन पैकेज मैट्रिक्स में न बदलना पड़े। इसे अपने प्रोजेक्ट पर पॉइंट करें और इसे कुक करने दें।

सुरक्षा मॉडल

yolobox दुर्घटनाओं से सुरक्षा है, कोई जादुई एंटी-कंटेनर-एस्केप प्रमेय नहीं।

यह आपकी होम डायरेक्टरी, SSH कीज़, डॉटफाइल्स, असंबंधित प्रोजेक्ट्स, और अधिकांश होस्ट फाइलसिस्टम स्टेट को लापरवाह विनाशकारी कमांड्स से बचाने में मदद करता है। यह उस प्रोजेक्ट डायरेक्टरी की रक्षा नहीं करता जिसे आपने माउंट किया, उन सीक्रेट्स की जिन्हें आप स्पष्ट रूप से फॉरवर्ड करते हैं, उन होस्ट एक्शन्स की जिन्हें आप स्पष्ट रूप से ब्रिज करते हैं, या रनटाइम एस्केप वल्नरेबिलिटीज़ से होस्ट कर्नेल की।

अधिक कसा हुआ बॉक्स के लिए, ऐसे फ्लैग्स को मिलाएँ:

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