kosa8

Claude Code के लिए kosa8 प्लगइन

kosa8: AI एजेंटों के लिए सुरक्षित इन्फ्रास्ट्रक्चर।

Claude को काम करने के लिए एक सीलबंद मशीन दें। यह प्लगइन Claude Code को kosa8 से जोड़ता है, जो AI एजेंटों के लिए सुरक्षित इन्फ्रास्ट्रक्चर है: हर एजेंट को अपनी सीलबंद मशीन मिलती है—अपने कर्नेल वाला एक वास्तविक microVM, न कि होस्ट का कर्नेल साझा करने वाला कंटेनर।

प्लगइन सक्षम होने पर, Claude ये काम कर सकता है:

• अविश्वसनीय या एजेंट द्वारा लिखे गए कोड को एक सीलबंद microVM में चला सकता है, जिसे होस्ट पर केवल एक फ़ोल्डर (वर्कस्पेस) दिखता है और कुछ नहीं;
• बंद नेटवर्क के पीछे काम कर सकता है, जहाँ केवल आपकी लिखी अनुमति-सूची में शामिल होस्ट तक पहुँचा जा सकता है और बाकी सभी कनेक्शन अस्वीकार कर दिए जाते हैं;
• API कुंजियों को अपने पास रखे बिना उनका उपयोग कर सकता है: होस्ट पर मौजूद एक egress broker बाहर जाते समय उन्हें जोड़ता है और sandbox में केवल एक placeholder रहता है;
• जोखिम भरे कदम से पहले लगभग 0.7 सेकंड में पूरी चलती मशीन—मेमोरी और प्रक्रियाओं सहित—का checkpoint बना सकता है और कुछ गड़बड़ होने पर लगभग एक सेकंड में उसे वापस ला सकता है, वह भी चलते हुए;
• अलग-अलग तरीकों को समानांतर में आज़माने और काम करने वाले तरीके को बनाए रखने के लिए चलती मशीन की लाइव प्रतियाँ बना सकता है;
• जोखिम भरी कार्रवाइयों के लिए एक या दो नामित मानव अनुमोदकों की प्रतीक्षा कर सकता है (दो-व्यक्ति नियम), और हर कार्रवाई को hash-chained, छेड़छाड़ का पता लगाने योग्य audit log में दर्ज कर सकता है।

प्लगइन के चार भाग हैं:

• एक MCP server (.mcp.json), जो kosa8 mcp serve को scripts/kosa8-mcp के ज़रिए स्थानीय stdio प्रक्रिया के रूप में शुरू करता है।
• एक skill (skills/kosa8-sandbox), जो Claude को बताती है कि sandbox का उपयोग कब करना है और checkpoints, rewind, fork, egress अनुमति-सूचियों और अनुमोदनों का सुरक्षित उपयोग कैसे करना है।
• कमांड: /kosa8:status, /kosa8:sandbox <task>, /kosa8:checkpoint, /kosa8:rewind (rewind करने से पहले पूछता है) और /kosa8:explore (कई कमांड को समानांतर forks में आज़माता है)।
• एजेंट: sandbox-runner अविश्वसनीय या जनरेट किए गए कोड को सीलबंद microVM में चलाता है और बताता है कि उसने क्या किया; fork-explorer एक चल रहे sandbox के समानांतर forks में तरीकों की तुलना करता है।

आवश्यकताएँ

• Claude Code।
• उसी मशीन पर kosa8 इंस्टॉल होना चाहिए, और kosa8 आपके PATH पर होना चाहिए। kosa8 Apple-chip Macs और x86-64 Linux पर, तथा Windows पर WSL2 के ज़रिए (preview) चलता है। इसे kosa8.com/download से इंस्टॉल करें। रिलीज़ पर हस्ताक्षर किए गए हैं और उन्हें notarise किया गया है। इंस्टॉलेशन की जाँच kosa8 version से करें।
• kosa8 daemon चल रहा होना चाहिए। यह प्लगइन केवल एक launcher है: sandbox आपकी मशीन पर kosa8d द्वारा चलाए जाने वाले microVM हैं, इसलिए daemon चालू होने तक कुछ भी काम नहीं करेगा।

शुरू करने से पहले: kosa8 इंस्टॉल करें और daemon शुरू करें

यह प्लगइन kosa8 इंस्टॉल नहीं करता और इसके बिना चल नहीं सकता। नई मशीन पर:

# 1. Install kosa8 (macOS on Apple silicon, x86-64 Linux, or WSL2)
#    from https://kosa8.com/download/, then check it:
kosa8 version

# 2. Start the daemon that runs the microVMs:
kosa8 daemon start

# 3. Confirm both halves are up:
kosa8 version          # prints "kosa8 daemon <version> (up Ns)"
kosa8 mcp tools        # lists the tools this plugin exposes

अगर kosa8 version में kosa8 daemon: not running दिखे, तो kosa8 daemon start फिर से चलाएँ। MCP server daemon के बिना शुरू हो जाता है, लेकिन तब हर sandbox टूल cannot reach kosa8d का जवाब देता है।

उपयोगकर्ता के लिए यह server इंस्टॉल करने वाले एजेंट llms-install.md का पालन कर सकते हैं।

इंस्टॉल करें

Claude Code में, इस repository को marketplace के रूप में जोड़ें और प्लगइन इंस्टॉल करें:

/plugin marketplace add kosa8ai/kosa8-claude-plugin
/plugin install kosa8@kosa8

या अपने shell से:

claude plugin marketplace add kosa8ai/kosa8-claude-plugin
claude plugin install kosa8@kosa8

Claude Code को रीस्टार्ट करें (या /reload-plugins चलाएँ)। यह पुष्टि करने के लिए /mcp चलाएँ कि kosa8 server कनेक्ट है, और Claude से कहें, “kosa8 status जाँचें।”

होस्ट फ़ोल्डर साझा करना

डिफ़ॉल्ट रूप से, एजेंट होस्ट की कोई भी डायरेक्टरी sandbox में साझा नहीं कर सकते। उन्हें कोई प्रोजेक्ट फ़ोल्डर साझा करने देने के लिए, server को --allow-mount DIR (केवल पढ़ने के लिए) या --allow-mount DIR:rw के साथ शुरू करें। आप अपनी MCP server एंट्री जोड़कर ऐसा कर सकते हैं, उदाहरण के लिए किसी प्रोजेक्ट के .mcp.json में:

{
  "mcpServers": {
    "kosa8-workspace": {
      "command": "kosa8",
      "args": ["mcp", "serve", "--allow-mount", "/Users/you/code/api:rw"]
    }
  }
}

नेटवर्क और कुंजियाँ

Sandbox के लिए नेटवर्क एक्सेस उसे बनाते समय तय किया जाता है। किसी sandbox को केवल एक API तक पहुँच देने और बाकी सब कुछ रोकने के लिए, उसे अपने टर्मिनल से बनाएँ:

kosa8 sandbox create sealed --egress-allow api.anthropic.com

टूल

kosa8 mcp serve ये टूल उपलब्ध कराता है (kosa8 0.5.0 में kosa8 mcp tools द्वारा रिपोर्ट किए गए अनुसार):

टूल	यह क्या करता है
kosa8_status	जाँचता है कि kosa8 daemon चल रहा है या नहीं और उसका संस्करण बताता है
sandbox_create	अपने कर्नेल और container engine वाला एक पृथक microVM sandbox शुरू करता है
sandbox_list	Sandboxes की सूची दिखाता है, जिसमें यह भी शामिल है कि हर fork किस parent से आया
sandbox_run	Sandbox के निजी engine के भीतर एक container चलाता है, जो होस्ट से पृथक होता है
sandbox_pull	Sandbox के निजी engine में एक image खींचता है
sandbox_checkpoint	मेमोरी और चल रही प्रक्रियाओं सहित एक restore point सहेजता है
sandbox_checkpoint_list	Sandbox के restore points की सूची दिखाता है
sandbox_rewind	Sandbox को checkpoint पर वापस लाता है और प्रक्रियाएँ फिर से शुरू करता है
sandbox_fork	चल रहे sandbox के N स्वतंत्र forks बनाता है
sandbox_explore	Best-of-N: हर candidate command के लिए एक fork बनाता है, उन्हें एक साथ चलाता है और विजेता को बनाए रखता है
sandbox_snapshot	Sandbox की पूरी स्थिति को snapshot के रूप में कैप्चर करता है
sandbox_stop	Sandbox को हटाए बिना रोकता है
sandbox_start	रुके हुए sandbox को उसकी अपनी disk से शुरू करता है
sandbox_delete	Sandbox और उसके VM को रोककर हटाता है
snapshot_list	सहेजे गए sandbox snapshots की सूची दिखाता है
snapshot_restore	Snapshot से sandbox शुरू करता है और उसकी प्रक्रियाएँ फिर से चालू करता है
snapshot_rm	Snapshot हटाता है
container_run	Container को पूरा चलाता है और उसका output लौटाता है
container_exec	चल रहे container के भीतर एक command चलाता है
container_list	Containers की सूची दिखाता है
container_logs	Container का output प्राप्त करता है
container_stats	Container के CPU, memory और pid उपयोग की रिपोर्ट देता है
container_stop	चल रहे container को रोकता है
image_build	होस्ट डायरेक्टरी में मौजूद Dockerfile से image बनाता है
image_list	Images की सूची दिखाता है
image_pull	Registry से image खींचता है
network_create	एक पृथक bridge network बनाता है
network_list	Container networks की सूची दिखाता है
volume_create	एक नामित volume बनाता है
volume_list	नामित volumes की सूची दिखाता है

अपने इंस्टॉल किए गए संस्करण की सूची देखने के लिए kosa8 mcp tools चलाएँ।

यह प्लगइन क्या चलाता है

प्लगइन का एकमात्र executable scripts/kosa8-mcp है—एक छोटी shell script, जो आपकी मशीन पर पहले से इंस्टॉल kosa8 को ढूँढ़ती है और kosa8 mcp serve चलाती है। यह कुछ भी डाउनलोड या इंस्टॉल नहीं करती। प्लगइन स्वयं कहीं भी डेटा नहीं भेजता, किसी server से संपर्क नहीं करता और credentials नहीं पढ़ता।

अन्य MCP क्लाइंट

यही server आधिकारिक MCP Registry में io.github.kosa8ai/kosa8 के रूप में प्रकाशित है (देखें server.json)। इसे MCP bundle, kosa8-mcp.mcpb, के रूप में वितरित किया जाता है, जो हर GitHub release के साथ संलग्न होता है: इसमें एक manifest और वही छोटा launcher scripts/kosa8-mcp शामिल है। यह कुछ भी डाउनलोड या इंस्टॉल नहीं करता, इसलिए पहले kosa8 इंस्टॉल करें।

stdio server शुरू कर सकने वाला कोई भी MCP client सीधे kosa8 mcp serve भी चला सकता है।

गोपनीयता

kosa8 MCP server स्थानीय रूप से चलता है और उसी मशीन पर kosa8 daemon से बात करता है। kosa8 की गोपनीयता नीति के अनुसार, आपका एजेंट जो tool calls करता है, उनके arguments और results आपकी मशीन पर ही रहते हैं और कभी kosa8 तक नहीं पहुँचते। नीति में kosa8 सॉफ़्टवेयर द्वारा भेजी जाने वाली हर चीज़ और भेजे जाने का समय सूचीबद्ध है—जिसमें सशुल्क लाइसेंस के लिए licence checks भी शामिल हैं—और यह भी बताया गया है कि KOSA8_OFFLINE=1 से सभी outbound calls कैसे बंद करें।

पूरी नीति: https://kosa8.com/privacy/

मूल्य निर्धारण

kosa8 व्यावसायिक सॉफ़्टवेयर है। इस repository की प्लगइन फ़ाइलें मुफ़्त हैं और MIT लाइसेंस के अंतर्गत हैं, लेकिन kosa8 के लिए लाइसेंस आवश्यक है: हर उपयोगकर्ता को सभी सुविधाओं वाला 14-दिन का मुफ़्त trial मिलता है, जिसके लिए न खाते की ज़रूरत है, न कार्ड की। योजनाएँ $29 प्रति माह से शुरू होती हैं। देखें https://kosa8.com/pricing/.

सहायता और संपर्क

• ईमेल: contact@kosa8.com
• Issues: https://github.com/kosa8ai/kosa8-claude-plugin/issues
• वेबसाइट: https://kosa8.com

लाइसेंस

इस repository की फ़ाइलें MIT License के अंतर्गत जारी की गई हैं। यह लाइसेंस केवल इस repository की फ़ाइलों (Claude Code प्लगइन: इसका manifest, marketplace file, MCP configuration, skill, commands, agents, launcher, README और logo) पर लागू होता है। यह kosa8 सॉफ़्टवेयर पर लागू नहीं होता, जो व्यावसायिक सॉफ़्टवेयर है और अलग से अपनी शर्तों के अंतर्गत वितरित किया जाता है।