Graphicle کے ساتھ کوڈنگ ایجنٹس کے لیے مقامی کوڈ گراف اور میموری بنائیں

Graphicle کیا ہے؟

Graphicle ایک مقامی Rust پروگرام ہے جو کوڈنگ ایجنٹس کے لیے ریپوزٹری کے کوڈ گراف کو پروجیکٹ کی یادداشت کے ساتھ جوڑتا ہے۔ یہ فائلوں، فنکشنز، کلاسز، کالز اور امپورٹس کا اشاریہ بناتا ہے، جبکہ دستاویزات، فیصلے، طریقۂ کار اور ایجنٹس کے سابقہ سیشنز بھی یاد رکھتا ہے۔

جب کوئی ایجنٹ یا ڈویلپر سوال پوچھتا ہے تو Graphicle ایسے حوالہ شدہ اقتباسات واپس کرتا ہے جو ماخذ فائل اور لائنوں کی حد کی نشان دہی کرتے ہیں۔ کوڈ گراف اور بنیادی سیاق کے ٹولز API key یا اکاؤنٹ کے بغیر کام کرتے ہیں، اور Graphicle کہیں بھی ڈیٹا نہیں بھیجتا، جب تک آپ واضح طور پر کسی ایسے ماڈل یا کنیکٹر کو تشکیل نہ دیں جس کے لیے یہ ضروری ہو۔

Graphicle، Claude Code، Cursor، Codex، VS Code، Claude Desktop اور دیگر MCP کلائنٹس کے ساتھ کام کرتا ہے۔ یہ کمانڈ لائن انٹرفیس، MCP سرور، براؤزر ایپ اور SQLite پر مبنی واحد ڈیٹا اسٹور فراہم کرتا ہے۔

اہم خصوصیات

• کوڈ گراف: tree-sitter پر مبنی پارسر استعمال کرتے ہوئے فائلوں، سمبلز، کالز، امپورٹس، راستوں اور متاثرہ کوڈ کو دریافت کریں۔
• پروجیکٹ کی یادداشت: Markdown، PDF، Office اور HTML دستاویزات، نظرثانی شدہ فیصلوں، طریقۂ کار اور محفوظ کیے گئے ایجنٹ سیشنز میں تلاش کریں۔
• حوالہ شدہ سیاق: ماڈل کو کال کیے بغیر، ٹوکن بجٹ کے اندر کوڈ اور پروجیکٹ کی معلومات سے متعلقہ اقتباسات حاصل کریں۔
• ایجنٹ انضمام: ایک کمانڈ سے معاون کوڈنگ ایجنٹس کو MCP کے ذریعے مربوط کریں۔
• کوڈ سے منسلک یادداشت: نظرثانی شدہ یادداشتوں کو ان فنکشنز سے منسلک کیا جا سکتا ہے جن کی وہ وضاحت کرتی ہیں، اور کوڈ تبدیل ہونے پر وہ پرانی تصور ہو سکتی ہیں۔
• مقامی ترجیحی آپریشن: ڈیٹا مقامی طور پر محفوظ ہوتا ہے، اینڈ پوائنٹس پہلے سے loopback پر سنتے ہیں، اور Graphicle کوئی ٹیلی میٹری یا اکاؤنٹ استعمال نہیں کرتا۔
• خودکار ہم وقت سازی: جوابات سے پہلے تبدیل شدہ فائلیں ہم وقت ساز ہوتی ہیں، جبکہ Git hooks commits، merges اور checkouts کے بعد ہم وقت سازی کر سکتے ہیں۔

Graphicle انسٹال کریں

Graphicle فی الحال macOS اور Linux کو سپورٹ کرتا ہے۔ macOS یا Homebrew والے Linux سسٹم پر انسٹالیشن کا آسان ترین طریقہ یہ ہے:

brew install graphicle-ai/tap/graphicle

اگر Homebrew دستیاب نہ ہو تو ریلیز انسٹالر استعمال کریں:

curl -fsSL https://github.com/graphicle-ai/graphicle/releases/latest/download/install.sh | sh

آپ GitHub releases صفحے سے پلیٹ فارم کے لیے مخصوص آرکائیو بھی ڈاؤن لوڈ کر سکتے ہیں۔ مقامی Windows سپورٹ فی الحال دستیاب نہیں، اگرچہ README کے مطابق Linux انسٹالیشن WSL2 کے تحت کام کر سکتی ہے، لیکن ابھی اس کی جانچ نہیں کی گئی۔

ریپوزٹری ترتیب دیں

اس ریپوزٹری میں جائیں جسے آپ اپنے ایجنٹس سے سمجھوانا چاہتے ہیں، پھر سیٹ اپ چلائیں:

cd your-repo
graphicle setup

سیٹ اپ کا عمل ریپوزٹری کا اشاریہ بناتا ہے، اس کا کوڈ گراف تیار کرتا ہے اور دستیاب کوڈنگ ایجنٹس کو مربوط کرتا ہے۔ آپ کی مشین پر انسٹال کلائنٹس کے مطابق یہ Claude Code، Codex، Cursor، VS Code، Claude Desktop اور دیگر MCP کلائنٹس کے لیے MCP کنفیگریشن اپ ڈیٹ کر سکتا ہے۔

سیٹ اپ سیشن کیپچر بھی فعال کرتا ہے، Claude Code کی تلاشوں کو کوڈ گراف کی طرف بھیجتا ہے، AGENTS.md میں ایک مختصر حصہ شامل کرتا ہے اور Git hooks انسٹال کرتا ہے جو پروجیکٹ کو تازہ رکھنے میں مدد دیتے ہیں۔ Graphicle ہر تبدیل کی جانے والی فائل کی فہرست بناتا ہے اور ترمیم سے پہلے بیک اپ تیار کرتا ہے۔ سیٹ اپ کو انٹرایکٹو پرامپٹس کے بغیر چلانے کے لیے استعمال کریں:

graphicle setup --yes

انضمام کی تبدیلیاں واپس لینے کے لیے چلائیں:

graphicle disconnect

disconnect کمانڈ وہ چیزیں ہٹا دیتی ہے جو سیٹ اپ نے شامل کی تھیں۔ یہ ریپوزٹری کی موجودہ Graphify آؤٹ پٹ ڈائریکٹری حذف نہیں کرتی۔

ٹرمینل سے سوالات پوچھیں

سیٹ اپ کے بعد ریپوزٹری میں تلاش کے لیے graphicle ask استعمال کریں:

graphicle ask "where is tax added to prices?"

Graphicle فائل ناموں، لائنوں کی حدود، سمبلز اور اقتباسات کے ساتھ شواہد واپس کرتا ہے۔ نتیجہ اس طرح دکھائی دے سکتا ہے:

Evidence for "where is tax added to prices?"
4 excerpts · 598 of 3,000 tokens

[1] shop/pricing.py:1-7  price_with_tax()
    """Prices and tax."""
    TAX_RATE = 0.2

    def price_with_tax(price):
        """A price with the sales tax added."""
        return round(price * (1 + TAX_RATE), 2)

کسی ماڈل کی تشکیل کے بغیر ask شواہد دکھاتا ہے۔ Graphicle سے تحریری جواب حاصل کرنے کے لیے Anthropic، OpenAI یا Ollama جیسے معاون ماڈل فراہم کنندہ کو تشکیل دیں:

graphicle config set model anthropic

Ollama کے ذریعے مقامی ماڈلز اور OpenAI-compatible سرورز بھی معاونت یافتہ ہیں۔ ماڈل کی ترتیبات کے لیے کنفیگریشن دستاویزات دیکھیں۔

ایجنٹ کے ساتھ Graphicle استعمال کریں

جب graphicle setup کسی MCP کلائنٹ کو مربوط کر دے تو اپنے کوڈنگ ایجنٹ سے ریپوزٹری کے سوالات کے لیے Graphicle استعمال کرنے کو کہیں۔ مثال کے طور پر:

Graphicle استعمال کرکے معلوم کریں کہ ناکام درخواستوں کو کہاں دوبارہ آزمایا جاتا ہے۔

ایجنٹ Graphicle کے کوڈ گراف اور میموری ٹولز استعمال کر سکتا ہے، حوالہ شدہ اقتباسات حاصل کر سکتا ہے اور ان نتائج کو اپنی استدلالی صلاحیت کے ساتھ ملا سکتا ہے۔ Graphicle ایک MCP سرور فراہم کرتا ہے جس میں کوڈ گراف اور میموری ٹولز شامل ہیں۔ اس کے گراف ٹولز میں query_graph، get_neighbors اور shortest_path جیسے نام شامل ہیں۔

گراف اور پروجیکٹ کی یادداشت دیکھیں

Graphicle کی براؤزر ایپ کھولنے کے لیے چلائیں:

graphicle open

ایپ آپ کو کوڈ گراف، ماخذ مواد اور پروجیکٹ کی یادداشت دیکھنے دیتی ہے۔ مجوزہ یادداشتوں کا جائزہ لے کر انہیں منظور بھی یہیں کیا جا سکتا ہے۔

انسٹالیشن اور انضمام کا احاطہ کرنے والی صحت کی جانچ کے لیے چلائیں:

graphicle doctor

جب کوئی ایجنٹ مربوط نہ ہو سکے، ہم وقت سازی نامکمل معلوم ہو یا آپ تشکیل شدہ ماحول کی تصدیق کرنا چاہیں تو doctor استعمال کریں۔

انحصارات اور متاثرہ کوڈ دریافت کریں

Graphicle صرف کوڈ پر مبنی گراف تیار اور اس میں استفسار کر سکتا ہے۔ پہلے گراف نکالیں:

graphicle graph extract . --code-only

پھر پوچھیں کہ کون سا کوڈ کسی علامت پر منحصر ہے:

graphicle graph affected "retry()"

graph کمانڈ ریپوزٹری میں تلاش کر سکتی ہے، علامات کی وضاحت کر سکتی ہے، راستوں کا سراغ لگا سکتی ہے، اور ایک انٹرایکٹو HTML گراف برآمد کر سکتی ہے۔ --code-only موڈ کے لیے ماڈل کی ضرورت نہیں ہوتی۔

Graphicle پروجیکٹ کی دستاویزات میں موجود کوڈ کے تذکروں کو ان تعریفات سے بھی جوڑ سکتا ہے جن کا وہ حوالہ دیتے ہیں۔ ان تعلقات کی فہرست بنانے کے لیے دستاویز-لنکنگ graph کمانڈ استعمال کریں:

graphicle call graph.doc_links

جوابی ماڈل کے بغیر سیاق و سباق حاصل کریں

context کمانڈ کوڈ، دستاویزات، سیشنز، اور نظرثانی شدہ میموری سے متعلقہ اقتباسات حاصل کرتی ہے۔ یہ کسی ماڈل کو کال نہیں کرتی:

graphicle context

متعدد ریپوزٹریز پر مشتمل ورک اسپیس کے لیے پورے ورک اسپیس سے سیاق و سباق طلب کریں:

graphicle context --workspace

اس سے Graphicle اس وقت مفید ہوتا ہے جب ایک ریپوزٹری میں موجود نفاذ کا انحصار کسی دوسری ریپوزٹری کی دستاویزات یا سورس کوڈ پر ہو۔ ورک اسپیس کی MCP ترتیب MCP دستاویزات میں بیان کی گئی ہے۔

ہم وقت سازی اور رازداری کو سمجھیں

ہم وقت سازی کے دوران Graphicle .gitignore کا احترام کرتا ہے اور ماحول کی فائلوں، کلیدوں، اور اسناد کو چھوڑ دیتا ہے۔ سیشن کیپچر <private>...</private> حصوں کے اندر موجود مواد کو ہٹا دیتا ہے اور اسناد کو چھپا دیتا ہے۔

macOS پر، مقامی ڈیٹا کا مرکزی فولڈر ~/Library/Application Support/Graphicle ہے۔ Linux پر یہ ~/.local/share/graphicle ہے۔ graphicle graph extract کے ذریعے بنایا گیا گراف پروجیکٹ کے اندر .graphicle/ میں لکھا جاتا ہے۔

ایپ، HTTP اینڈ پوائنٹس، اور MCP اینڈ پوائنٹس بطور ڈیفالٹ 127.0.0.1 پر سنتے ہیں۔ نیٹ ورک تک رسائی صرف اس وقت ہوتی ہے جب آپ ایسی سہولت طلب کریں جس کے لیے اس کی ضرورت ہو، مثلاً ترتیب دیا گیا ماڈل یا کنیکٹر، مکمل گراف ایکسٹریکشن جو دستاویزات یا تصاویر کسی LLM کو بھیجتی ہو، منتخب GitHub CLI آپریشنز، یا اپ ڈیٹ فیڈ۔

اعلیٰ درجے کی تجاویز

جوابات کو شواہد پر مبنی رکھیں

ایجنٹ کے دعووں کی عین فائلوں اور لائنوں کے مقابل تصدیق کے لیے Graphicle کے حوالہ دیے گئے اقتباسات استعمال کریں۔ یہ خاص طور پر ڈیبگنگ، ناواقف ریپوزٹریز کو سمجھنے، اور تبدیلیوں کا جائزہ لینے کے لیے مفید ہے۔

تجویز کردہ میموری کا جائزہ لیں

ایجنٹ کی تجویز کردہ میموری خودکار طور پر قابلِ اعتماد پروجیکٹ علم نہیں بن جاتی۔ منظوری سے پہلے ایپ میں اس کا جائزہ لیں۔ کوڈ کی علامات سے منسلک میموری متعلقہ کوڈ میں تبدیلی کے وقت پرانی ہو سکتی ہے، جبکہ اسی فائل میں دیگر مقامات پر کی گئی ترامیم عموماً انہیں تازہ رکھتی ہیں۔

موجودہ سیاق و سباق کے لیے Git hooks استعمال کریں

سیٹ اپ کے دوران نصب کیے گئے hooks کو برقرار رکھ کر ریپوزٹری کو ہم وقت رکھیں۔ یہ commits، merges، اور checkouts کے بعد ہم وقت سازی کرتے ہیں، جبکہ Graphicle جواب دینے سے پہلے تبدیل شدہ فائلوں کو بھی ہم وقت کرتا ہے۔

ریپوزٹری کی حدود کو ایڈجسٹ کریں

بطور ڈیفالٹ، ایک پروجیکٹ میں زیادہ سے زیادہ 100,000 متنی فائلیں اور 1 GiB متن شامل ہو سکتا ہے۔ اگر آپ بڑی ریپوزٹری کے ساتھ کام کر رہے ہوں تو ترتیب میں یہ حدود بڑھائی جا سکتی ہیں۔ بہت بڑی فائلوں کا جزوی تجزیہ کیا جا سکتا ہے یا انہیں قابلِ تلاش متن کے طور پر محفوظ رکھا جا سکتا ہے، بجائے اس کے کہ ہم وقت سازی روک دی جائے۔

ایک اور MCP کلائنٹ جوڑیں

ان کلائنٹس کے لیے جنہیں Graphicle خودکار طور پر شناخت نہیں کرتا، MCP گائیڈ میں بیان کردہ مختصر JSON MCP ترتیب شامل کریں۔ یہی MCP سرور گراف اور میموری دونوں صلاحیتیں فراہم کرتا ہے۔

نتیجہ

Graphicle کوڈنگ ایجنٹس کو ریپوزٹری کے ڈھانچے اور پروجیکٹ کے علم کا مقامی، قابلِ تلاش منظر فراہم کرتا ہے۔ اسے انسٹال کریں، graphicle setup چلائیں، اور حوالہ جات کے ساتھ کوڈ کی تحقیق کے لیے ask، context، open، اور graph استعمال کریں۔ ماڈل صرف اس وقت ترتیب دیں جب آپ تخلیق کردہ جوابات چاہتے ہوں؛ گراف، ہم وقت سازی، MCP سرور، سیشن کیپچر، اور ایپ اس کے بغیر بھی کام کر سکتے ہیں۔

مزید تفصیل کے لیے پروجیکٹ کی فوری شروعات، ایجنٹ گائیڈ، ترتیب کا حوالہ، اور اکثر پوچھے گئے سوالات جاری رکھیں۔