इस प्रोजेक्ट के बारे में

Swarm एक स्थानीय-प्रथम नियंत्रण तल है जो एक साथ कई AI कोडिंग एजेंट चलाने वाले डेवलपर्स के लिए डिज़ाइन किया गया है। यह आपकी मशीन पर एकल डेमॉन के रूप में चलता है, और उन hooks, transcripts और session logs को पढ़ता है जो Claude Code, Codex CLI, Gemini CLI, Grok, Aider और opencode जैसे एजेंट पहले से उत्पन्न करते हैं — आपके रिपॉजिटरी में शून्य इंस्ट्रुमेंटेशन परिवर्तन की आवश्यकता होती है। सारा state ~/.swarm/ में रहता है और डैशबोर्ड 127.0.0.1 से बंधता है, इसलिए कुछ भी आपकी मशीन से बाहर नहीं जाता, किसी खाते की आवश्यकता नहीं होती, और यह ऑफ़लाइन काम करता है। मूल मूल्य अवलोकन और समन्वय है। Fleet दृश्य हर प्रोजेक्ट के हर सत्र को वास्तविक समय में दिखाता है: कौन सा एजेंट चल रहा है, किस ब्रांच पर, वह अभी क्या कर रहा है, मॉडल, आउटपुट टोकन, संदर्भ आकार, लागत और आयु। एक सत्र जो बार-बार विफल कमांड दोहराने लगता है, उसे Stuck बैज और डेस्कटॉप सूचना मिलती है। Session दृश्य एजेंट के तर्क और टूल कॉल को लाइव स्ट्रीम करता है, साथ में प्रति-टर्न लागत, कैश हिट दर, सोच हिस्सा और टूल हिस्टोग्राम। Replay टूल कॉल को पूर्ण इनपुट और आउटपुट के साथ एक-एक करके चलाता है, और समाप्त सत्र को उसके खत्म होने की जगह से फिर से शुरू किया जा सकता है। Board किसी प्रोजेक्ट के लिए समन्वय बही के रूप में कार्य करता है। यह markdown बैकलॉग, GitHub Issues या Linear से कार्यों को ट्रैक करता है, साथ में pass/fail गेट्स और Run/Dispatch क्रियाएँ। कार्य दावों को पृथक git worktrees में रखा जाता है, प्रत्येक में ब्रांच, ड्रिफ्ट, गंदा/अनपुश्ड स्थिति, और उसके अंदर का सत्र होता है। रनटाइम संसाधन — पोर्ट, डेव सर्वर, डेटाबेस — नामित सिंगलटन के रूप में रखे जाते हैं। Incidents हर उस कमांड को रिकॉर्ड करते हैं जिसके बारे में नियमों ने पूछा या जिसे अस्वीकार किया, साथ में Codify क्रिया जो उसे .swarm.toml नियम और CLAUDE.md पाठ में बदल देती है। Rules उन Bash कमांडों पर सुरक्षा रेलिंग हैं जो Claude Code सत्र चलाता है: shared_tree, destructive_git, pattern_kill, protected_ports, no_foreign_worktree और claim_required_to_write। प्रत्येक .swarm.toml में प्रति रिपोजिटरी ask, deny या off पर सेट होता है। deny को Claude Code को वास्तविक अनुमति अस्वीकृति के रूप में लौटाया जाता है। संसाधनों के रूप में रखे गए पोर्ट स्वचालित रूप से सुरक्षित रहते हैं। ये दुर्घटनाओं से बचने के लिए सुरक्षा रेलिंग हैं, सैंडबॉक्स नहीं। Swarm एजेंट भी उत्पन्न कर सकता है: swarm run --task X किसी कार्य का दावा करता है और उसके worktree में claude -p चलाता है, जिसे stdin से नियंत्रित किया जा सकता है और pid से रोका जा सकता है। swarm dispatch --ready हर दावे योग्य कार्य को उसकी अपनी run में सौंपता है, एक बार में N कार्य। Run प्रोफाइल (full, no-edits, read-only) सीमित करते हैं कि उत्पन्न एजेंट क्या कर सकता है। .swarm.toml में घोषित Gates कार्य के worktree में निष्पादित होते हैं — exit 0 पास होता है, आउटपुट का अंतिम भाग साक्ष्य होता है। हर रुका हुआ सत्र auto-handoff छोड़ता है जिसमें संपादित फाइलें, अंतिम सत्यापन कमांड और अंतिम अनुरोध होता है; उस worktree में अगला सत्र इसे शुरुआत में इंजेक्ट करवा लेता है। जो एजेंट किसी ऐसे निर्णय पर पहुँचता है जो केवल मानव ले सकता है, वह swarm_ask कहता है; प्रश्न सत्र पृष्ठ पर बटनों के रूप में विकल्पों के साथ दिखता है, Fleet पर Asking बैज दिखता है, डेस्कटॉप सूचना आती है, और उत्तर अपने आप एजेंट तक पहुँच जाता है। .swarm.toml में घोषित Declarative workflows स्वचालित रूप से आगे बढ़ते हैं: run चरण एजेंट उत्पन्न करते हैं, gate चरणों को जारी रखने के लिए पास होना चाहिए, और pr ब्रांच को push करता है और pull request खोलता है। swarm_send के माध्यम से एजेंट-से-एजेंट संदेश किसी अन्य सत्र तक id द्वारा पहुँचता है, जो भी कार्य धारण करता है, या मुख्य सत्र तक। PRs दृश्य GitHub और GitLab के बीच एक मर्ज कतार प्रदान करता है, जो आपके पहले से प्रमाणित gh या glab CLI के माध्यम से पढ़ा जाता है। कोई टोकन संग्रहीत नहीं होते। Timeline 3–72 घंटों में प्रति प्रोजेक्ट सत्र लेन दिखाता है, जो एजेंट द्वारा रंगीन होते हैं। Spend और Stats लागत को प्रोजेक्ट, मॉडल, एजेंट और कार्य द्वारा विभाजित करते हैं, साथ में context-budget तालिका जो सत्रों को उनके द्वारा पुनः पढ़े गए संदर्भ की मात्रा के आधार पर क्रमबद्ध करती है। प्रति-रिपोजिटरी बजट दैनिक या साप्ताहिक सीमाएँ लागू करते हैं जो चेतावनी देते हैं, पूछते हैं या रोकते हैं। Outcomes ट्रैक करते हैं कि कार्य कायम रहा या नहीं: सत्र एक ब्रांच से जुड़ते हैं, ब्रांच उसके PR से, PR मर्ज या revert से, प्रति मॉडल और प्रति एजेंट मर्ज दर, मर्ज तक माध्य समय और प्रति मर्ज डॉलर के साथ स्कोर किया जाता है। एक लाइव bipartite ग्राफ चल रहे सत्रों को उन फाइलों के विपरीत दिखाता है जिन्हें वे छूते हैं; एक फ़ाइल जिसे दो सत्र पकड़ते हैं और कम से कम एक लेखक होता है, वह लाल हो जाती है — एक मर्ज विरोध जिसे आप अभी भी रोक सकते हैं। Swarm CLI (bunx @ra3orblade/swarm setup), डेस्कटॉप ऐप (macOS हस्ताक्षरित और notarized, Windows, Linux .deb/.rpm) और MCP सर्वर के रूप में उपलब्ध है जो एजेंटों को स्वयं समन्वय करने देता है। team डेमॉन (swarm-teamd) बहु-मशीन सेटअप के लिए एक स्व-होस्टेड दूसरी सेवा है, जो ऑडिट इवेंट, spend rollups और दावों को अग्रेषित करती है — जब तक कोई मशीन ऑप्ट-इन न करे, कभी transcript पाठ नहीं। team पैकेज FSL-1.1-ALv2 के अंतर्गत source-available है, जो प्रत्येक रिलीज़ के दो वर्ष बाद Apache-2.0 में परिवर्तित हो जाता है; बाकी सब Apache-2.0 है।