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

# Crush ٹرمینل کے لیے ایک شاندار ایجنٹک کوڈنگ اسسٹنٹ، جسے Charmbracelet نے بنایا ہے۔ یہ آپ کے ٹولز، کوڈبیس، اور ورک فلو کو آپ کی پسند کے LLM سے براہ راست کمانڈ لائن کے ذریعے جوڑتا ہے۔ ## اہم صلاحیتیں - **ملٹی ماڈل سپورٹ**: LLMs کی وسیع رینج میں سے انتخاب کریں یا OpenAI- یا Anthropic- مطابقت رکھنے والی APIs کے ذریعے اپنا خود کا کنفیگر کریں۔ سیاق و سباق کو برقرار رکھتے ہوئے سیشن کے وسط میں ماڈل تبدیل کریں۔ - **LSP انٹیگریشن**: IDE کے طریقہ کار کی طرح کوڈبیس کا اضافی سیاق و سباق جمع کرنے کے لیے لینگویج سرور پروٹوکول استعمال کرتا ہے۔ - **MCP ایکسٹینشن**: `http`، `stdio`، اور `sse` ٹرانسپورٹس کا استعمال کرتے ہوئے ماڈل کانٹیکسٹ پروٹوکول سرورز کے ذریعے قابل توسیع۔ - **سیشن مینجمنٹ**: فی پروجیکٹ متعدد ورک سیشنز اور سیاق و سباق برقرار رکھیں، SSE پر کراس کلائنٹ ورک اسپیس شیئرنگ کے ساتھ۔ - **کنفیگرایبل**: کسٹم پرووائیڈرز، ماڈلز، اجازتوں، اور مہارتوں کے لیے Bash پر مبنی `crushrc` کنفیگریشن فائلیں۔ JSON کنفیگریشن بھی سپورٹ کرتا ہے۔ - **تھیمز**: بلٹ ان کلر تھیمز لائیو پیش نظارہ اور کمانڈ پیلیٹ (`ctrl+p`) کے ذریعے حسب ضرورت کے ساتھ۔ - **ایجنٹ اسکلز**: [Agent Skills](https://agentskills.io) اوپن اسٹینڈرڈ کو سپورٹ کرتا ہے قابل استعمال اسکل پیکجز کے لیے جو عالمی اور پروجیکٹ ڈائریکٹریز سے دریافت کیے جا سکتے ہیں۔ - **اجازت کا نظام**: دانے دار ٹول اجازتیں — انفرادی طور پر منظور کریں، ٹول کیٹیگریز کی اجازت/انکار کریں، یا `--yolo` کے ساتھ پرامپٹس کو مکمل طور پر چھوڑ دیں۔ - **کراس پلیٹ فارم**: macOS، Linux، Windows (PowerShell/WSL)، Android، FreeBSD، OpenBSD، اور NetBSD پر کام کرتا ہے۔ ## انسٹالیشن Homebrew، NPM، Arch Linux (btw)، Nix، FreeBSD pkg، Debian/Ubuntu apt، Fedora/RHEL yum، Winget، Scoop، اور براہ راست Go انسٹال کے ذریعے دستیاب ہے۔ ## پرووائیڈرز Charm Hyper (ڈیفالٹ، پرائیویسی پر مرکوز، صفر ڈیٹا برقرار رکھنے کے ساتھ)، Anthropic، OpenAI، Gemini، OpenRouter، Groq، Hugging Face، Amazon Bedrock، Azure OpenAI، Alibaba، اور بہت سے دیگر کو سپورٹ کرتا ہے۔ ماحولیاتی متغیرات یا کنفیگریشن فائلیں API کیز سیٹ کر سکتی ہیں۔ OpenAI/Anthropic APIs کے ساتھ مطابقت رکھنے والا تقریباً کوئی بھی پرووائیڈر کسٹم پرووائیڈر کے طور پر شامل کیا جا سکتا ہے۔ ## سیاق و سباق کا انتظام - `.gitignore` کا احترام کرتا ہے اور اضافی فائل اخراج کے لیے `.crushignore` کو سپورٹ کرتا ہے۔ - کراس پروجیکٹ ہدایات کے لیے `~/.config/crush/CRUSH.md` اور `~/.config/AGENTS.md` پر عالمی سیاق و سباق کی فائلیں۔ - LSPs اور MCPs پروجیکٹ سے متعلقہ سیاق و سباق کے ساتھ ایجنٹ کے فیصلوں کو تقویت دیتے ہیں۔ ## کنفیگریشن Crush خود کنفیگریشن کے لیے ایک بلٹ ان اسکل کے ساتھ آتا ہے۔ ایک `crushrc` ایک Bash اسکرپٹ ہے جس میں Crush سے متعلق بلٹ انز ہوتے ہیں، جو Windows سمیت تمام پلیٹ فارمز پر یکساں رویہ فراہم کرتا ہے۔ کنفیگریشن کی ترجیح عالمی کنفیگریشنز سے پہلے پروجیکٹ لوکل کنفیگریشنز پر لاگو ہوتی ہے۔ پرانا JSON کنفیگریشن فارمیٹ اب بھی سپورٹ کیا جاتا ہے لیکن اسے متروک قرار دیا گیا ہے۔