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 hook commit, merge এবং checkout-এর পর সিঙ্ক করতে পারে।

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 hook ইনস্টল করে। 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-সামঞ্জস্যপূর্ণ সার্ভারও সমর্থিত। মডেল সেটিংসের জন্য কনফিগারেশন ডকুমেন্টেশন দেখুন।

এজেন্টের সঙ্গে 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()"

গ্রাফ কমান্ডটি রিপোজিটরি অনুসন্ধান করতে, প্রতীক ব্যাখ্যা করতে, পাথ অনুসরণ করতে এবং একটি ইন্টার‌্যাক্টিভ HTML গ্রাফ রপ্তানি করতে পারে। --code-only মোডের জন্য কোনো মডেলের প্রয়োজন হয় না।

Graphicle প্রকল্পের নথিতে থাকা কোডের উল্লেখগুলোকে সেগুলো যে সংজ্ঞাগুলো নির্দেশ করে, সেগুলোর সঙ্গেও সংযুক্ত করতে পারে। ওই সম্পর্কগুলো তালিকাভুক্ত করতে ডকুমেন্ট-লিংকিং গ্রাফ কমান্ডটি ব্যবহার করুন:

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 হুক ব্যবহার করুন

সেটআপের সময় ইনস্টল করা হুকগুলো রেখে রিপোজিটরিকে সিঙ্ক্রোনাইজড রাখুন। কমিট, মার্জ এবং চেকআউটের পর এগুলো সিঙ্ক করে, আর কোনো উত্তর দেওয়ার আগে Graphicle পরিবর্তিত ফাইলগুলোও সিঙ্ক্রোনাইজ করে।

রিপোজিটরির সীমা সমন্বয় করুন

ডিফল্টভাবে, একটি প্রকল্পে সর্বোচ্চ 100,000টি টেক্সট ফাইল এবং 1 GiB টেক্সট থাকতে পারে। বড় রিপোজিটরি নিয়ে কাজ করলে কনফিগারেশনে এই সীমা বাড়ানো যায়। খুব বড় ফাইল আংশিকভাবে বিশ্লেষণ করা হতে পারে বা সিঙ্ক্রোনাইজেশন বন্ধ না করে অনুসন্ধানযোগ্য টেক্সট হিসেবে রাখা হতে পারে।

অন্য একটি MCP ক্লায়েন্ট সংযুক্ত করুন

Graphicle যেসব ক্লায়েন্ট স্বয়ংক্রিয়ভাবে শনাক্ত করে না, সেগুলোর জন্য MCP গাইডে বর্ণিত সংক্ষিপ্ত JSON MCP কনফিগারেশন যোগ করুন। একই MCP সার্ভার গ্রাফ এবং মেমরি, উভয় সক্ষমতা প্রদান করে।

উপসংহার

Graphicle কোডিং এজেন্টদের রিপোজিটরির কাঠামো এবং প্রকল্পের জ্ঞানের একটি স্থানীয়, অনুসন্ধানযোগ্য ভিউ দেয়। এটি ইনস্টল করুন, graphicle setup চালান এবং উদ্ধৃতিসহ কোড অনুসন্ধান করতে ask, context, open ও graph ব্যবহার করুন। তৈরি করা উত্তর চাইলে তবেই কোনো মডেল কনফিগার করুন; গ্রাফ, সিঙ্ক্রোনাইজেশন, MCP সার্ভার, সেশন ক্যাপচার এবং অ্যাপ মডেল ছাড়াই কাজ করতে পারে।

আরও বিস্তারিত জানতে প্রকল্পের দ্রুত শুরু নির্দেশিকা, এজেন্ট গাইড, কনফিগারেশন রেফারেন্স এবং FAQ পড়ুন।