finbarr/yoloboxअपने 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/projectAI सैंडबॉक्स के अंदर पूरी तरह से उधम मचा सकता है। आपकी असली होम डायरेक्टरी? बिल्कुल सुरक्षित।
# 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
बेयर yolobox को Codex लॉन्च करने के लिए default_harness = "codex" सेट करें। जब आप मैन्युअल शेल चाहते हैं तो yolobox shell का उपयोग करें, और जब आप सैंडबॉक्स में एक कमांड चलाना चाहते हैं तो yolobox run <cmd...> का उपयोग करें।
पूर्ण स्थापना और रनटाइम विवरण स्थापना और सेटअप में हैं। कमांड उदाहरण कमांड्स में हैं।
बेस इमेज में AI CLI, Node.js, Python, Go, Bun, बिल्ड टूल्स, Git, GitHub CLI, ripgrep, fd, fzf, jq, vim, RTK, और सामान्य उपयोगी चीज़ें शामिल हैं।
और कुछ चाहिए? एजेंट के पास sudo है।
yolobox के अंदर, समर्थित AI CLI को अनुमति प्रॉम्प्ट छोड़ने के लिए रैप किया गया है। कोई पुष्टि नहीं, कोई गार्डरेल नहीं। बस शुद्ध बिना फ़िल्टर किया हुआ AI, जैसा प्रकृति ने चाहा था।
पूर्ण टूल सूची, YOLO-मोड रैपर तालिका, RTK नोट्स, npm पैकेज ताज़गी नीति, और बंडल किए गए CLI अपग्रेड व्यवहार के लिए, बॉक्स में क्या है देखें।
यदि किसी प्रोजेक्ट को अतिरिक्त टूल या एनवायरनमेंट वेरिएबल्स की आवश्यकता है, तो पूरी बेस इमेज को फोर्क करने के बजाय एक छोटा प्रोजेक्ट कॉन्फ़िग जोड़ें:
# .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) के साथ alias करें:
# .yolobox.toml
env_from_host = ["GH_TOKEN=YOLOBOX_READONLY_GH_TOKEN"]
यह alias उस वेरिएबल का स्वामी होता है: यह उसी कुंजी के लिए स्वचालित पासथ्रू और --gh-token को दबा देता है, और यदि होस्ट वेरिएबल सेट नहीं है तो yolobox शुरू होने से मना कर देता है, ताकि यह जिस टोकन को बदलता है वह कभी भी गलती से लीक न हो सके।
प्रोजेक्ट env सेटिंग्स के लिए कॉन्फ़िगरेशन देखें, और पैकेज इंस्टॉल, Dockerfile फ्रैगमेंट, रीबिल्ड व्यवहार, अपग्रेड व्यवहार, और पूरी तरह से कस्टम इमेज के लिए प्रोजेक्ट-स्तरीय अनुकूलन देखें।
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 in the persistent box
विस्तृत संदर्भ जानबूझकर दस्तावेज़ साइट पर हैं:
fork, और उदाहरणyolobox इंसानों के लिए नहीं, बल्कि AI एजेंटों के लिए डिज़ाइन किया गया है। आप AI लॉन्च करते हैं और उसे काम करने देते हैं।
एजेंट के पास कंटेनर के अंदर sudo है। यदि उसे कंपाइलर, डेटाबेस, पैकेज, या फ्रेमवर्क की आवश्यकता है, तो वह उसे इंस्टॉल कर सकता है। नामित वॉल्यूम उस सेटअप को सत्रों के बीच बनाए रखते हैं, इसलिए आपको README को सौ पंक्तियों के पैकेज मैट्रिक्स में बदलने की आवश्यकता नहीं है। इसे अपने प्रोजेक्ट पर इंगित करें और इसे काम करने दें।
yolobox दुर्घटनाओं से सुरक्षा है, न कि कंटेनर-एस्केप रोकने का कोई जादुई प्रमेय।
यह आपकी होम डायरेक्टरी, SSH कुंजियाँ, डॉटफ़ाइल, असंबंधित प्रोजेक्ट, और अधिकांश होस्ट फाइलसिस्टम स्थिति को लापरवाह विनाशकारी कमांड्स से बचाने में मदद करता है। यह उस प्रोजेक्ट डायरेक्टरी की रक्षा नहीं करता जिसे आपने माउंट किया है, उन रहस्यों की नहीं जिन्हें आप स्पष्ट रूप से फॉरवर्ड करते हैं, होस्ट क्रियाओं की नहीं जिन्हें आप स्पष्ट रूप से ब्रिज करते हैं, या रनटाइम एस्केप कमजोरियों से होस्ट कर्नेल की नहीं।
अधिक सख्त बॉक्स के लिए, निम्न जैसे फ्लैग्स को संयोजित करें:
yolobox claude --no-network --no-env-passthrough --readonly-project --exclude ".env*" --exclude "secrets/**"
यदि आप लापरवाह कोड के बजाय शत्रुतापूर्ण कोड के बारे में चिंतित हैं, तो rootless Podman या VM जैसे मजबूत अलगाव का उपयोग करें। पूर्ण खतरा मॉडल और सख्तीकरण विकल्प सुरक्षा मॉडल में हैं।
make build
make test
make lint
make image
योगदानकर्ता वर्कफ़्लो, दस्तावेज़-साइट कमांड्स, वर्ज़निंग, और रिलीज़ नियम योगदान में हैं।
MIT