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

mgrep ایک کمانڈ لائن ٹول ہے جو لوکل فائلوں میں سیمانٹک، قدرتی زبان کی تلاش لاتا ہے، اور اسے grep کا متبادل نہیں بلکہ تکمیلی ٹول کے طور پر پیش کیا گیا ہے۔ یہ npm پیکج (@mixedbread/mgrep) کے طور پر Apache-2.0 لائسنس کے تحت تقسیم کیا جاتا ہے اور Mixedbread نے بنایا ہے۔ بنیادی صلاحیتیں: - کوڈ، ٹیکسٹ، PDFs اور تصاویر پر قدرتی زبان کی تلاش۔ آڈیو اور ویڈیو سپورٹ جلد آنے والی ہے۔ - `mgrep watch` کے ذریعے پس منظر میں انڈیکسنگ، جو ابتدائی مطابقت پذیری کرتی ہے، .gitignore اور اختیاری .mgrepignore فائل کا احترام کرتی ہے، اور فائلوں میں تبدیلی پر کلاؤڈ بیسڈ Mixedbread اسٹور کو اپ ڈیٹ رکھتی ہے۔ - `--web` کے ذریعے ویب تلاش، جو مقامی نتائج کے ساتھ `mixedbread/web` اسٹور کو کوری کرتی ہے؛ `--answer` خلاصہ شدہ جواب پیدا کرتا ہے۔ - `--agentic` کے ذریعے ایجنٹک تلاش، جو پیچیدہ سوالات کو ذیلی سوالات میں تقسیم کرتی ہے اور متعدد تلاشیں چلاتی ہے۔ - ڈیفالٹ طور پر نتائج کی دوبارہ ترتیب (reranking)، جسے `--no-rerank` یا MGREP_RERANK=0 سے غیر فعال کیا جا سکتا ہے۔ - نتائج میں رشتہ دار راستے اور سیاق و سباق کے اشارے شامل ہوتے ہیں جیسے ٹیکسٹ کے لیے لائن رینجز اور PDFs کے لیے صفحہ نمبر۔ تصدیق اور ترتیب: - `mgrep login` ڈیوائس/براؤزر فلو استعمال کرتا ہے؛ ہیڈ لیس یا CI ماحول MXBAI_API_KEY سیٹ کر سکتے ہیں۔ - انسٹالیشن `npm install -g @mixedbread/mgrep` کے ذریعے ہے (pnpm/bun کا بھی ذکر ہے)۔ کوڈنگ ایجنٹ انٹیگریشنز: - Claude Code، OpenCode، Codex اور Factory Droid کے لیے معاون انسٹال کمانڈز موجود ہیں (install-claude-code, install-opencode, install-codex, install-droid)۔ - README نوٹ کرتا ہے کہ جب کوڈنگ ایجنٹ کے ساتھ انسٹال کیا جاتا ہے، تو ایک پس منظر عمل سیشن کے دوران فائلوں کو مطابقت پذیر کرتا ہے اور سیشن ختم ہونے پر رک جاتا ہے۔ - ڈیفالٹ حدیں 1MB فی فائل اور 1,000 فائلیں فی ڈائریکٹری ہیں، جنہیں CLI فلیگز، ماحولیاتی متغیرات یا کنفیگریشن فائلوں کے ذریعے ایڈجسٹ کیا جا سکتا ہے۔ کنفیگریشن: - مقامی `.mgreprc.yaml`/`.mgreprc.yml` یا گلوبل `~/.config/mgrep/config.yaml`۔ - ترجیح: CLI فلیگز، پھر ماحولیاتی متغیرات، پھر مقامی کنفیگ، پھر گلوبل کنفیگ، پھر ڈیفالٹس۔ - ماحولیاتی متغیرات تصدیق (MXBAI_API_KEY)، اسٹور انتخاب (MXBAI_STORE)، تلاش کے رویے (MGREP_MAX_COUNT, MGREP_CONTENT, MGREP_ANSWER, MGREP_WEB, MGREP_AGENTIC, MGREP_SYNC, MGREP_DRY_RUN, MGREP_RERANK) اور مطابقت پذیری کی حدیں (MGREP_MAX_FILE_SIZE, MGREP_MAX_FILE_COUNT) کا احاطہ کرتے ہیں۔ - `--store <name>` ورک اسپیس کو الگ کرتا ہے؛ اسٹورز ضرورت پر بنائے جاتے ہیں۔ کمانڈز کا جائزہ: `mgrep`/`mgrep search`، `mgrep watch`، `mgrep login`، `mgrep logout`، اور چار ایجنٹ انسٹال کمانڈز۔ ڈیولپمنٹ: TypeScript پروجیکٹ جو pnpm کے ساتھ بنایا گیا ہے؛ `pnpm build`، `pnpm dev`، `pnpm format` (biome)، `pnpm typecheck`؛ ٹیسٹ bats استعمال کرتے ہیں۔ README کہتا ہے کہ ٹیسٹ ابھی مکمل طور پر مربوط نہیں ہیں۔ بینچ مارک دعوی: README ایک اندرونی 50-ٹاسک QA بینچ مارک کی رپورٹ کرتا ہے جہاں mgrep Claude Code کے ساتھ grep پر مبنی ورک فلو کے مقابلے میں تقریباً 2x کم ٹوکنز استعمال کرتا ہے، یکساں یا بہتر معیار کے ساتھ، جس میں جیت کی شرح کا فیصلہ LLM کرتا ہے۔ یہ پروجیکٹ کے اپنے دعوے ہیں اور یہاں ان کی آزادانہ تصدیق نہیں کی گئی۔ ٹربل شوٹنگ نوٹس بار بار لاگ ان پرامپٹس، شور والے واچرز، اور اسٹور کو دوبارہ بنانے کا احاطہ کرتے ہیں۔ سپورٹ Mixedbread Slack کمیونٹی کے ذریعے پیش کی جاتی ہے۔