منصوبے کے بارے میں

Swarm ایک مقامی کنٹرول پلین ہے جو ڈویلپرز کے لیے ڈیزائن کیا گیا ہے جو بیک وقت متعدد AI کوڈنگ ایجنٹ چلاتے ہیں۔ یہ آپ کی مشین پر ایک واحد ڈیمن کے طور پر چلتا ہے، اور ان ہکس، ٹرانسکرپٹس، اور سیشن لاگز کو پڑھتا ہے جو Claude Code، Codex CLI، Gemini CLI، Grok، Aider، اور opencode جیسے ایجنٹ پہلے سے تیار کرتے ہیں — آپ کے ریپوزٹریز میں کسی بھی انسٹرومینٹیشن تبدیلی کی ضرورت نہیں۔ تمام ڈیٹا ~/.swarm/ میں محفوظ ہوتا ہے اور ڈیش بورڈ 127.0.0.1 سے منسلک ہوتا ہے، لہذا کچھ بھی آپ کی مشین سے باہر نہیں جاتا، کسی اکاؤنٹ کی ضرورت نہیں، اور یہ آف لائن کام کرتا ہے۔ بنیادی قدر مشاہدہ اور کوآرڈینیشن ہے۔ Fleet ویو ہر پروجیکٹ کے ہر سیشن کو ریئل ٹائم میں دکھاتا ہے: کون سا ایجنٹ چل رہا ہے، کس برانچ پر، وہ اس وقت کیا کر رہا ہے، ماڈل، آؤٹ پٹ ٹوکنز، سیاق و سباق کا سائز، لاگت، اور عمر۔ ایک سیشن جو بار بار ناکام کمانڈ دہرانے لگتا ہے اسے Stuck بیج اور ڈیسک ٹاپ نوٹیفکیشن ملتا ہے۔ Session ویو ایجنٹ کی reasoning اور ٹول کالز کو لائیو سٹریم کرتا ہے، جس میں فی ٹرن لاگت، کیش ہٹ ریٹ، سوچ کا حصہ، اور ٹول ہسٹوگرام شامل ہوتا ہے۔ Replay ٹول کالز کو ایک ایک کرکے مکمل ان پٹ اور آؤٹ پٹ کے ساتھ دکھاتا ہے، اور ختم شدہ سیشن کو وہیں سے دوبارہ شروع کیا جا سکتا ہے جہاں سے وہ رکا تھا۔ Board ایک پروجیکٹ کے لیے کوآرڈینیشن لیجر کے طور پر کام کرتا ہے۔ یہ مارک ڈاؤن بیک لاگ، GitHub Issues، یا Linear سے کاموں کو ٹریک کرتا ہے، جس میں پاس/فیل گیٹس اور Run/Dispatch ایکشنز شامل ہیں۔ کام کے دعوے الگ تھلگ git ورک ٹریز میں رکھے جاتے ہیں، ہر ایک برانچ، drift، گندا/غیر پش شدہ حالت، اور اس کے اندر سیشن کے ساتھ۔ رن ٹائم وسائل — پورٹس، ڈیولپمنٹ سرورز، ڈیٹا بیس — نامزد سنگلٹن کے طور پر رکھے جاتے ہیں۔ Incidents ہر اس کمانڈ کو ریکارڈ کرتا ہے جس کے بارے میں قواعد نے پوچھا یا انکار کیا، جس میں Codify ایکشن ہوتا ہے جو اسے .swarm.toml قاعدہ اور CLAUDE.md سبق میں تبدیل کرتا ہے۔ قواعد 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 ایک کام کا دعوی کرتا ہے اور اس کے ورک ٹری میں claude -p شروع کرتا ہے، جسے stdin سے چلایا جا سکتا ہے اور pid سے روکا جا سکتا ہے۔ swarm dispatch --ready ہر قابل دعوی کام کو اس کی اپنی run میں دیتا ہے، ایک وقت میں N۔ Run پروفائلز (full، no-edits، read-only) پیدا شدہ ایجنٹ کے اختیارات کو محدود کرتے ہیں۔ .swarm.toml میں اعلان کردہ گیٹس کام کے ورک ٹری میں چلائے جاتے ہیں — exit 0 پاس کرتا ہے، آؤٹ پٹ کا اختتام ثبوت ہے۔ ہر سیشن جو رکتا ہے ایک خودکار ہینڈ آف چھوڑتا ہے جس میں ترمیم شدہ فائلیں، آخری تصدیقی کمانڈ، اور آخری درخواست ہوتی ہے؛ اگلے سیشن کو وہیں شروع میں انجیکٹ کیا جاتا ہے۔ ایک ایجنٹ جو کسی فیصلے پر پہنچتا ہے جو صرف انسان کر سکتا ہے وہ swarm_ask کہتا ہے؛ سوال سیشن پیج پر بٹن کے طور پر دکھایا جاتا ہے، Fleet پر Asking بیج دکھاتا ہے، ڈیسک ٹاپ نوٹیفکیشن آتا ہے، اور جواب ایجنٹ تک پہنچتا ہے۔ .swarm.toml میں اعلان کردہ ورک فلو خود بخود آگے بڑھتے ہیں: run مراحل ایجنٹ پیدا کرتے ہیں، gate مراحل کو جاری رکھنے کے لیے پاس ہونا ضروری ہے، اور pr برانچ کو دھکیلتا ہے اور پل ریکویسٹ کھولتا ہے۔ swarm_send کے ذریعے ایجنٹ سے ایجنٹ پیغام رسانی کسی دوسرے سیشن تک id سے، جو بھی کام رکھتا ہے، یا لیڈ سیشن تک پہنچتی ہے۔ PRs ویو GitHub اور GitLab کے درمیان ایک مرج قطار فراہم کرتا ہے، جو آپ کے پہلے سے تصدیق شدہ gh یا glab CLI کے ذریعے پڑھا جاتا ہے۔ کوئی ٹوکن محفوظ نہیں ہوتے۔ Timeline ہر پروجیکٹ کے سیشن لین دکھاتا ہے، ایجنٹ کے لحاظ سے رنگین، 3–72 گھنٹے کے دوران۔ Spend اور Stats لاگت کو پروجیکٹ، ماڈل، ایجنٹ، اور کام کے لحاظ سے تقسیم کرتے ہیں، جس میں سیاق و سباق کے بجٹ کی میز ہوتی ہے جو سیشنز کو اس لحاظ سے درجہ دیتی ہے کہ وہ کتنا سیاق و سباق دوبارہ پڑھتے ہیں۔ فی ریپو بجٹ روزانہ یا ہفتہ وار حدیں نافذ کرتے ہیں جو خبردار کرتی ہیں، پوچھتی ہیں، یا روکتی ہیں۔ Outcomes ٹریک کرتا ہے کہ آیا کام زندہ رہا: سیشن برانچ سے جڑتے ہیں، برانچ اپنے PR سے، PR مرج یا revert سے، فی ماڈل اور فی ایجنٹ اسکور کے ساتھ مرج ریٹ، مرج کا درمیانی وقت، اور فی مرج ڈالر۔ ایک لائیو بائی پارٹائٹ گراف چلنے والے سیشنز کو ان فائلوں کے خلاف دکھاتا ہے جنہیں وہ چھوتے ہیں؛ ایک فائل جسے دو سیشن رکھتے ہیں اور کم از کم ایک لکھنے والا سرخ ہو جاتا ہے — ایک مرج تصادم جسے آپ روک سکتے ہیں۔ Swarm ایک CLI (bunx @ra3orblade/swarm setup)، ڈیسک ٹاپ ایپ (macOS دستخط شدہ اور نوٹرائزڈ، Windows، Linux .deb/.rpm)، اور ایک MCP سرور کے طور پر دستیاب ہے جو ایجنٹوں کو خود کوآرڈینیٹ کرنے دیتا ہے۔ ٹیم ڈیمن (swarm-teamd) ایک خود میزبان دوسری سروس ہے جو ملٹی مشین سیٹ اپ کے لیے ہے، آڈٹ ایونٹس، خرچ رول اپ، اور دعوے آگے بھیجتی ہے — ٹرانسکرپٹ متن کبھی نہیں جب تک کہ کوئی مشین آپٹ ان نہ کرے۔ ٹیم پیکیج FSL-1.1-ALv2 کے تحت سورس دستیاب ہے، جو ہر ریلیز کے دو سال بعد Apache-2.0 میں تبدیل ہوتا ہے؛ باقی سب Apache-2.0 ہے۔