
yolobox v0.19.4
अपने AI को पूरी ताकत से चलने दें। आपकी होम निर्देशिका सुरक्षित रहती है।
██╗ ██╗ ██████╗ ██╗ ██████╗ ██████╗ ██████╗ ██╗ ██╗
╚██╗ ██╔╝██╔═══██╗██║ ██╔═══██╗██╔══██╗██╔═══██╗╚██╗██╔╝
╚████╔╝ ██║ ██║██║ ██║ ██║██████╔╝██║ ██║ ╚███╔╝
╚██╔╝ ██║ ██║██║ ██║ ██║██╔══██╗██║ ██║ ██╔██╗
██║ ╚██████╔╝███████╗╚██████╔╝██████╔╝╚██████╔╝██╔╝ ██╗
╚═╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝
अपने AI को पूरी छूट दें। आपकी होम डायरेक्टरी होम ही रहेगी।
डॉक्स: yolobox.dev
चेंजलॉग: CHANGELOG.md
Claude Code, Codex, Kimi Code, Gemini, Antigravity, OpenCode, Copilot, Pi, या किसी भी AI कोडिंग एजेंट को "yolo mode" में चलाएँ, बिना अपनी होम डायरेक्टरी को तबाह किए।
समस्या
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
Homebrew स्वचालित रूप से bash और zsh completions इंस्टॉल करता है। स्क्रिप्ट इंस्टॉल के लिए, shell completions देखें।
फिर किसी भी प्रोजेक्ट से:
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 क्लाइंट या एडिटर के लिए, इसके stdio एजेंट कमांड के रूप में yolobox run codex-acp या yolobox run claude-agent-acp का उपयोग करें। एडाप्टर संगत इंजन बंडल करते हैं और क्लाइंट के अनुमति मोड का उपयोग करते हैं; yolobox के CLI YOLO रैपर और --no-yolo उन्हें नियंत्रित नहीं करते। मौजूदा कॉन्फ़िग सिंक और प्रमाणीकरण विकल्प लागू होते हैं। लॉन्च उदाहरणों के लिए ACP clients देखें।
इमेज पुल और कस्टम-इमेज बिल्ड प्रगति stderr पर जाती है, जिससे stdout और पाइप किया गया stdin कंटेनर कमांड के लिए उपलब्ध रहता है, ACP स्टार्टअप के दौरान भी।
पूरी टूल सूची, 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"]
यह alias उस वेरिएबल का स्वामित्व रखता है: यह उसी key के लिए स्वचालित passthrough और --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 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
yolobox reset --force # Remove yolobox volumes from the configured runtime
Reset Docker, Podman और Apple container के साथ काम करता है। यह केवल मौजूदा yolobox volumes को हटाता है और तब सफल होता है जब कोई शेष न हो। yolobox uninstall --force बाइनरी और global config को हटाने से पहले उन volumes को भी साफ़ करता है; runtime विफलता uninstall को रोक देती है ताकि इसे पुनः प्रयास किया जा सके। runtime डेटा को सुरक्षित रखते हुए uninstall करने के लिए --keep-volumes जोड़ें।
इमेज में OpenCode v2 (@opencode/cli) शामिल है। yolobox update-agents opencode भी v2 इंस्टॉल करता है, launcher विरोध से बचने के लिए पहले persistent npm prefix से पुराने opencode-ai पैकेज को हटाता है। इंस्टॉल स्पष्ट रूप से आवश्यक postinstall स्क्रिप्ट की अनुमति देते हैं। उपयोगकर्ता द्वारा इंस्टॉल की गई मौजूदा v1 प्रतियाँ तब तक बनी रहती हैं जब तक आप उन्हें अपडेट नहीं करते; केवल नई इमेज खींचना persistent tools को प्रतिस्थापित नहीं करता।
OpenCode v2 opencode कमांड और मौजूदा config स्थानों को बनाए रखता है। स्विच करने से पहले अपने सेटअप का बैकअप लें: v1 plugins और server API integrations को माइग्रेशन की आवश्यकता है। upstream migration guide देखें।