NanoClaw – Apple container isolation environment में चलने वाला 500-line TypeScript-आधारित Claude assistant

• NanoClaw Apple container में चलने वाला एक personal Claude-आधारित AI assistant है, जो single-process architecture और बहुत कम files वाले lightweight system के रूप में बना है
• हर group-स्तरीय container isolation के जरिए chat history और file system को अलग रखा जाता है, और यह WhatsApp messaging, scheduled tasks, web access आदि को support करता है
• किसी config file के बिना Claude Code installation और customization को guide करता है, और user सीधे code बदलकर इसे अपने अनुसार ढाल सकता है
• नए features code जोड़कर नहीं बल्कि ‘Skill’ files से extend किए जाते हैं, और /add-telegram, /convert-to-docker जैसी कई extension requests दी गई हैं
• जटिल frameworks की जगह समझ में आने वाली security structure और simplicity को प्राथमिकता दी गई है, ताकि solo developers या startups सुरक्षित रूप से AI assistant बना सकें

---

परियोजना अवलोकन

• NanoClaw, Apple Container environment में चलने वाला एक personal Claude assistant है, जिसे lightweight और security को केंद्र में रखकर design किया गया है
  • यह एक single Node.js process में चलता है, और हर agent Linux container के भीतर isolated file system का उपयोग करता है
  • codebase लगभग 500 lines के TypeScript से बना है, और इसका दावा है कि user पूरी structure को 8 मिनट के भीतर समझ सकता है
• यह MIT license के तहत open source है और GitHub पर 500 से अधिक Stars प्राप्त कर चुका है

design philosophy

• समझने योग्य scale: microservices, message queues, या जटिल abstractions के बिना single process structure
• isolation के जरिए security: केवल explicitly mounted directories तक access संभव है, और Bash commands भी सिर्फ container के अंदर चलती हैं
• single-user focus: framework नहीं बल्कि personal software, जिसे fork करने के बाद सीधे modify किया जा सकता है
• config की जगह code edits: config files को न्यूनतम रखा गया है, और इच्छित behavior code changes से लागू किया जाता है
• AI-native approach: installation, debugging, monitoring — सब कुछ Claude Code conversational interface के जरिए
• skill-based extensibility: feature additions code changes से नहीं बल्कि .claude/skills directory की skill files से की जाती हैं

मुख्य features

• WhatsApp I/O: phone से सीधे Claude के साथ message exchange
• group-wise context isolation: हर group का अपना CLAUDE.md memory और container file system होता है
• main channel: administration के लिए personal channel, जो बाकी groups से पूरी तरह अलग है
• scheduled tasks: periodic jobs चलाना और automatic messages भेजना
• web access: search और content collection capabilities
• optional integrations: /add-gmail जैसी skills के जरिए Gmail सहित external services integration

customization

• बिना config file के Claude Code conversation के जरिए सीधे changes किए जा सकते हैं
  • उदाहरण: “trigger word को @Bob में बदलो”, “responses को और छोटा करो”, “हर हफ्ते conversation summary save करो”
• /customize command step-by-step modification support देता है
• codebase छोटा होने के कारण Claude इसे सीधे और सुरक्षित रूप से modify कर सकता है

विस्तार और contribution model

• नए features PR के रूप में सीधे जोड़ने के बजाय skills के रूप में दिए जाते हैं
  • उदाहरण: /add-telegram, /add-slack, /add-discord जैसी communication channel extensions
  • /convert-to-docker से Apple Container को Docker में बदला जा सकता है
  • /setup-windows से WSL2-आधारित Windows support
  • /add-clear से session summary और compression feature जोड़ा जा सकता है
• contributors skills के जरिए अपने fork को बदलते हैं और फिर उसे वापस project के साथ share करते हैं

system requirements और structure

• macOS Tahoe(26) या उससे ऊपर, Node.js 20+, Claude Code, Apple Container आवश्यक हैं
• architecture flow:
  WhatsApp (baileys) → SQLite → Polling loop → Container (Claude Agent SDK) → Response
• मुख्य files:
  • src/index.ts: main app और WhatsApp connection
  • src/container-runner.ts: container execution management
  • src/task-scheduler.ts: scheduling features
  • src/db.ts: SQLite integration
  • groups/*/CLAUDE.md: group-wise memory storage

FAQ सारांश

• WhatsApp क्यों: क्योंकि author व्यक्तिगत रूप से WhatsApp इस्तेमाल करता है; दूसरे channels skills से बदले जा सकते हैं
• Apple Container क्यों: macOS में built-in, lightweight और fast
• क्या Linux पर चल सकता है: Claude Code के जरिए लगभग 30 मिनट में port किया जा सकता है
• security: container isolation आधारित, explicit mounts के अलावा access संभव नहीं
• config files क्यों नहीं: config sprawl रोकने और code-centric customization बनाए रखने के लिए
• debugging कैसे: Claude Code से सीधे पूछकर problem solving
• किस तरह के changes allowed हैं: केवल security, bug fixes, और default configuration improvements

license

• MIT License के तहत वितरित
• कोई भी इसे स्वतंत्र रूप से modify और redistribute कर सकता है