कोडिंग एजेंटों को सुरक्षित रूप से चलाने के लिए एक अल्ट्रा-फास्ट, ओपन-सोर्स सैंडबॉक्स।

VibeBox macOS (Apple Virtualization Framework) पर कोडिंग एजेंट चलाने के लिए एक प्रति-प्रोजेक्ट माइक्रो-VM सैंडबॉक्स है। यह दैनिक उपयोग वर्कफ़्लो के लिए अनुकूलित है: तेज़ वार्म री-एंट्री, स्पष्ट माउंट और पुन: प्रयोज्य सत्र।

यह किसके लिए है: macOS उपयोगकर्ता जो कोडिंग एजेंट चलाते हैं और तेज़ दैनिक वर्कफ़्लो छोड़े बिना वास्तविक अलगाव चाहते हैं।

त्वरित तथ्य: मेरे M3 पर वार्म री-एंट्री आमतौर पर <5s है (मशीन/कैश के अनुसार भिन्न); पहली बार चलाने पर डेबियन बेस इमेज डाउनलोड और प्रोविज़न होता है (नेटवर्क पर निर्भर)।

सुरक्षा मॉडल: vibebox.toml से स्पष्ट माउंट अलाउलिस्ट के साथ Linux गेस्ट VM (प्रोजेक्ट-फर्स्ट, बाकी सब ऑप्ट-इन)।

सेकंड में एंटर/अटैच: vibebox आपको मौजूदा रेपो के लिए पुन: प्रयोज्य सैंडबॉक्स में डालता है
डिफ़ॉल्ट रूप से प्रोजेक्ट-स्कोप्ड: स्पष्ट माउंट + रेपो-सम्मिलित बदलाव (प्रोजेक्ट-फर्स्ट, बाकी सब अलाउलिस्टेड)
सेशन-आधारित: मल्टी-इंस्टेंस + सेशन प्रबंधन (पुन: उपयोग, एकाधिक टर्मिनल, सफाई)

त्वरित डेमो

# किसी भी रेपो से
cd my-project
vibebox

आपको क्या दिखना चाहिए (लगभग):

vibebox: starting (session: my-project)
vibebox: attaching...
vibecoder@vibebox:~/my-project$

मैंने VibeBox क्यों बनाया

मैं रोज़ाना कोडिंग एजेंट का उपयोग करता हूँ, और मैं उन्हें अपनी होस्ट मशीन सौंपे बिना एक वास्तविक शेल देना चाहता था। अगर चीज़ों को लॉक डाउन करते हैं तो लगातार कन्फर्मेशन मिलते हैं; ढीला करते हैं तो फ़ाइलें हटाने, सीक्रेट्स को छूने, या रेपो के बाहर जाने की चिंता होती है।

VibeBox बीच का रास्ता है: एक कड़ी VM सीमा, तेज़ री-एंट्री और स्पष्ट माउंट वाला प्रति-रेपो सैंडबॉक्स। इसे एजेंट के काम के लिए "हमेशा चालू" रहने के लिए बनाया गया है, बिना सुरक्षा को एक काम-चोर बनाए।

माइक्रो-VM क्यों (कंटेनरों के मुकाबले)?

कंटेनर बहुत अच्छे हैं। VibeBox सेवाएँ बनाने के लिए Docker/devcontainers को बदलने की कोशिश नहीं करता।

मैं विशेष रूप से macOS पर एजेंट वर्कफ़्लो के लिए एक VM-आकार का डिफ़ॉल्ट चाहता था:

डिफ़ॉल्ट रूप से गेस्ट-कर्नेल आइसोलेशन सीमा: जब मैं एक एजेंट को मनमाने कमांड चलाने दे रहा हूँ, तो मैं चाहता हूँ कि "सुरक्षित मोड" Linux गेस्ट हो, मेरी होस्ट नहीं।
सत्र एक प्रथम-श्रेणी वर्कफ़्लो के रूप में: प्रति रेपो अटैच/पुन: उपयोग, एक ही सैंडबॉक्स में कई टर्मिनल, अनाथ वातावरण से बचने के लिए विश्वसनीय सफाई।
प्राथमिक UX के रूप में स्पष्ट माउंट अलाउलिस्ट: डिफ़ॉल्ट रूप से रेपो-स्कोप्ड; बाकी सब एक स्पष्ट निर्णय है।
न्यूनतम प्रति-रेपो सेटअप: आप compose/devcontainers के साथ इसके कुछ हिस्सों को दोहरा सकते हैं, लेकिन मैं एक एकल कमांड चाहता था जो रेपो-दर-रेपो काम करे, बिना मूल "सुरक्षित शेल" वर्कफ़्लो के लिए कंटेनर कॉन्फ़िगरेशन बनाए रखे।

तुलना

यहाँ कारण है कि मैंने मौजूदा विकल्पों का उपयोग नहीं किया:

vibe: बहुत सुविधाजनक और "बिना कॉन्फ़िग के, बस चलाएं" को नेल करता है। VibeBox जानबूझकर एक अलग अक्ष पर है: प्रति-रेपो कॉन्फ़िग + सत्र + मल्टी-इंस्टेंस लाइफसाइकिल।
QEMU: शक्तिशाली, लेकिन कॉन्फ़िगरेशन सरफेस बहुत बड़ा है। रोज़ाना सैंडबॉक्सिंग के लिए यह "रेपो खोलें और चलाएं" नहीं है — यह अपने आप में एक प्रोजेक्ट है।
Docker / devcontainers / devpods: बढ़िया इकोसिस्टम। मेरी समस्या कच्चा स्टार्टअप समय नहीं था, बल्कि बुनियादी वर्कफ़्लो के लिए प्रति-रेपो कंटेनर कॉन्फ़िगरेशन बनाए रखे बिना एजेंट सैंडबॉक्स को डिफ़ॉल्ट रूप से सुरक्षित (माउंट अलाउलिस्ट, सीक्रेट एक्सपोज़र, अटैच/रीयूज़, सफाई) रखने का दैनिक ओवरहेड था।

इसी ने मुझे VibeBox बनाने के लिए प्रेरित किया: मैं एक प्रति-प्रोजेक्ट सैंडबॉक्स चाहता था जिसमें प्रवेश करना तेज़ हो (बस vibebox), वास्तविक कॉन्फ़िगरेशन + सत्रों का समर्थन करता हो, और एक कड़ी आइसोलेशन सीमा बनाए रखता हो।

इंस्टॉलेशन

# इंस्टॉल स्क्रिप्ट
curl -fsSL https://raw.githubusercontent.com/robcholz/vibebox/main/install | bash

# पैकेज मैनेजर
cargo install vibebox

# मैन्युअल इंस्टॉल
curl -LO https://github.com/robcholz/vibebox/releases/download/latest/vibebox-macos-arm64.zip
unzip vibebox-macos-arm64.zip
mkdir -p ~/.local/bin
mv vibebox ~/.local/bin
export PATH="$HOME/.local/bin:$PATH"

आवश्यकताएँ

Apple Silicon पर macOS (VibeBox Apple के वर्चुअलाइज़ेशन API का उपयोग करता है)।

पहला रन

पहला vibebox रन एक डेबियन बेस इमेज डाउनलोड करता है और उसे प्रोविज़न करता है। उसके बाद, प्रति-प्रोजेक्ट इंस्टेंस तेज़ स्टार्टअप के लिए कैश्ड बेस इमेज का पुन: उपयोग करते हैं।

दस्तावेज़ीकरण

त्वरित आरंभ

cd /path/to/your/project
vibebox

पहली बार चलाने पर, VibeBox आपके प्रोजेक्ट में vibebox.toml (यदि अनुपलब्ध हो) और इंस्टेंस डेटा के लिए .vibebox/ डायरेक्टरी बनाता है।

कॉन्फ़िगरेशन (vibebox.toml)

vibebox.toml डिफ़ॉल्ट रूप से आपके प्रोजेक्ट रूट में रहता है। आप इसे vibebox -c path/to/vibebox.toml या VIBEBOX_CONFIG_PATH एनव वेरिएबल से ओवरराइड कर सकते हैं, लेकिन पथ प्रोजेक्ट डायरेक्टरी के अंदर ही रहना चाहिए।

डिफ़ॉल्ट कॉन्फ़िग (अनुपलब्ध होने पर स्वतः निर्मित):

[box]
cpu_count = 2
ram_mb = 2048
disk_gb = 5
mounts = [
    "~/.codex:~/.codex:read-write",
    "~/.claude:~/.claude:read-write",
]

[supervisor]
auto_shutdown_ms = 20000

disk_gb केवल तब लागू होता है जब इंस्टेंस डिस्क पहली बार बनाई जाती है। यदि आप बाद में इसे बदलते हैं, तो डिस्क को पुनः बनाने के लिए vibebox reset चलाएँ।

माउंट

आपका प्रोजेक्ट ~/<project-name> पर रीड-राइट माउंट किया जाता है, और शेल वहीं से शुरू होता है।
यदि .git डायरेक्टरी मौजूद है, तो गेस्ट से आकस्मिक संपादनों को हतोत्साहित करने के लिए इसे VM के अंदर tmpfs माउंट के साथ मास्क किया जाता है।
अतिरिक्त माउंट host:guest[:read-only|read-write] प्रारूप में box.mounts से आते हैं।
होस्ट पथ ~ विस्तार का समर्थन करते हैं। सापेक्ष गेस्ट पथ को /root/<path> के रूप में माना जाता है।
~ का उपयोग करने वाले गेस्ट पथ सुविधा के लिए /home/<ssh-user> में लिंक किए जाते हैं। हल किए गए होस्ट/गेस्ट मैपिंग देखने के लिए vibebox explain चलाएँ।

CLI कमांड

vibebox             # वर्तमान प्रोजेक्ट VM शुरू या अटैच करें
vibebox list        # ज्ञात प्रोजेक्ट सत्रों की सूची देखें
vibebox reset       # इस प्रोजेक्ट के लिए .vibebox हटाएँ और अगली बार चलाने पर पुनः बनाएँ
vibebox purge-cache # वैश्विक कैश (~/.cache/vibebox) हटाएँ
vibebox explain     # माउंट और नेटवर्क जानकारी दिखाएँ

VM के अंदर

डिफ़ॉल्ट SSH उपयोगकर्ता: vibecoder
होस्टनाम: vibebox
बेस इमेज प्रोविज़निंग स्थापित करता है: बिल्ड टूल्स, git, curl, ripgrep, openssh-server, और sudo।
पहले लॉगिन पर, VibeBox mise स्थापित करता है और uv, node, @openai/codex, और @anthropic-ai/claude-code जैसे टूल्स कॉन्फ़िगर करता है (प्रयास-आधारित)।
शेल उपनाम: :help और :exit।

स्टेट और कैश

प्रोजेक्ट स्टेट .vibebox/ में रहता है (इंस्टेंस डिस्क, SSH कुंजियाँ, लॉग्स, मैनेजर सॉकेट/पीआईडी)। vibebox reset इसे हटाता है।
वैश्विक कैश ~/.cache/vibebox में रहता है (बेस इमेज + साझा गेस्ट कैश)। vibebox purge-cache इसे साफ करता है।
सत्र सूचकांक ~/.vibebox/sessions में रहता है और vibebox list द्वारा दिखाया जाता है।

योगदान

यदि आप VibeBox में योगदान देने में रुचि रखते हैं, तो कृपया पुल रिक्वेस्ट सबमिट करने से पहले हमारे योगदान दस्तावेज़ पढ़ें।

FAQ

यह अन्य सैंडबॉक्स से कैसे अलग है?

VibeBox न्यूनतम अनुष्ठान के साथ तेज़, दोहराने योग्य स्थानीय सैंडबॉक्स के लिए बनाया गया है। यहाँ क्या अलग है:

मेरे M3 पर वार्म री-एंट्री आमतौर पर <5s है (मशीन/कैश के अनुसार भिन्न), जिससे आप जल्दी वापस आ सकते हैं।
एक सरल कमांड — vibebox — आपको अपने प्रोजेक्ट से सैंडबॉक्स में डालता है।
कॉन्फ़िगरेशन vibebox.toml में रहता है, जहाँ आप CPU, RAM, डिस्क आकार और माउंट सेट कर सकते हैं।
सत्र प्रथम-श्रेणी हैं: पुन: उपयोग, एकाधिक टर्मिनल, सफाई।

विशेष धन्यवाद

lynaghk द्वारा vibe।

और अद्भुत Rust समुदाय — इकोसिस्टम और crates.io जैसी टूलचेन के बिना यह संभव नहीं होता!

मुझे X पर फ़ॉलो करें x.com/robcholz

vibebox

सबसे लोकप्रिय