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

Genie AI کوڈنگ ایجنٹس کے لیے کمانڈ لائن پلاننگ اور ایگزیکیوشن لیئر ہے۔ اس کا نعرہ "wishes in, PRs out" ہے: آپ ایک جملے میں بتاتے ہیں کہ آپ کیا چاہتے ہیں، اور Genie آپ کا انٹرویو کر کے ایک پلان بناتا ہے، ایجنٹس کو متوازی طور پر اسے بنانے کے لیے بھیجتا ہے، قبولیت کے معیار کے خلاف نتیجے کا جائزہ لیتا ہے، اور merge کے لیے تیار چیز واپس دیتا ہے۔ آرکیٹیکچر جان بوجھ کر کم سے کم ہے۔ کوئی daemons اور کوئی Postgres نہیں: بنیادی حصہ skills کا ایک مجموعہ ہے، git میں محفوظ سادہ markdown دستاویزات، اور Bun کے بلٹ اِن انجن پر ایک واحد فی-repo SQLite فائل (`.genie/genie.db`)۔ ایک کمانڈ ڈیٹا بیس کھولتی ہے، ایک transaction چلاتی ہے، اور باہر نکل جاتی ہے۔ بنڈل کو تقریباً 0.9 MB اور چار runtime dependencies کے ساتھ بیان کیا گیا ہے، اور `nats` صرف اس وقت initialize ہوتا ہے جب Omni runner شروع ہوتا ہے۔ انسٹالیشن ایک curl-piped shell script ہے۔ Releases cosign-signed ہیں SLSA provenance کے ساتھ، اور installer `gh attestation verify` کے ذریعے binary کی تصدیق کرتا ہے جس میں `cosign verify-blob` fallback ہے۔ تین سطحیں فراہم کی جاتی ہیں: signed binary، skills (skills.sh چینل کے ذریعے، یا `npx skills add automagik-dev/genie` کے ذریعے)، اور ایک اختیاری Orca plugin جو Orca کی طرف رجسٹر ہوتا ہے۔ ورک فلو skill-driven ہے: `brainstorm` (idea سے DESIGN.md اور design review)، `wish` (design سے scoped WISH.md execution groups کے ساتھ)، `review` (لازمی plan review)، `work` (native role subagents ہر منظور شدہ group بناتے ہیں)، اور آخری آزاد implementation review جو SHIP، FIX-FIRST، یا BLOCKED واپس کرتا ہے۔ Skills runtime-neutrally لکھی جاتی ہیں اور ہر detected agent skill home میں install ہوتی ہیں (Claude Code، مشترکہ `~/.agents/skills` home جو Codex اور دیگر استعمال کرتے ہیں، Goose، Windsurf)۔ State اور دستاویزات الگ ہیں: wishes، designs اور brainstorms `.genie/` کے تحت markdown ہیں، جبکہ tasks، boards، dependency edges اور execution state SQLite میں رہتے ہیں۔ ایک repo کے linked worktrees ایک ہی ڈیٹا بیس شیئر کرتے ہیں جو git common directory سے resolve ہوتا ہے، لہٰذا tasks بغیر sync step کے تمام worktrees میں نظر آتے ہیں۔ ایک `genie context` کمانڈ versioned JSON emit کرتی ہے جو spawn context (branch، base SHA، ready tasks) بیان کرتی ہے۔ Genie کے دو lifecycle modes ہیں۔ `standalone` default ہے؛ `genie setup --orchestration-mode orca` ایک compatible runtime کی تصدیق کے بعد Orca کو واحد lifecycle authority بناتا ہے، اور اس mode میں Genie خاموشی سے fallback کرنے کے بجائے local lifecycle reads/writes سے انکار کرتا ہے۔ legacy MCP server اور UI bridge ریٹائر کر دیے گئے ہیں، `genie mcp` اور `genie ui-bridge` مستحکم diagnostics کے ساتھ non-zero exit کرتے ہیں۔ ایک اختیاری `genie omni` bridge ایک چل رہے agent کو NATS کے ذریعے Omni hub کے ذریعے WhatsApp سے جوڑتا ہے تاکہ remote approvals اور inbound one-shots ممکن ہوں۔ قابل ذکر آپریشنل تفصیلات: `genie doctor` install health اور فی-agent skill کی موجودگی رپورٹ کرتا ہے؛ `genie update` plugin-era leftovers کی retirement backup-first طریقے سے سنبھالتا ہے، modified یا ambiguous assets محفوظ رکھتے ہوئے؛ `genie uninstall` صرف وہ artifacts delete کرتا ہے جو ثابت ہو سکیں کہ Genie-owned ہیں۔ README واضح کرتا ہے کہ live WhatsApp round-trip ایک documented manual-QA step ہے، جبکہ Omni behavior test suite میں fake transport کے خلاف verify کیا جاتا ہے۔