প্রকল্প সম্পর্কে

Vole AI কোডিং এজেন্টগুলোর জন্য একটি লোকাল-ফার্স্ট ব্যবহার, খরচ ও অসঙ্গতি মনিটর। এটি সেই ডেভেলপারদের জন্য তৈরি, যারা একসঙ্গে একাধিক এজেন্ট চালান এবং কোনো এজেন্ট শুধু কত খরচ করেছে তা নয়, বরং সে অস্বাভাবিক আচরণ করছে কিনা তা জানতে চান। অ্যাপটি Apple silicon-এর জন্য macOS 26+-এ চলে এবং মেনু বারে থাকে। এটি কোডিং টুলগুলো যে লগগুলো ইতিমধ্যেই ডিস্কে লেখে সেগুলো পড়ে, একটি সাধারণ স্কিমায় রূপান্তর করে এবং সবকিছু স্থানীয়ভাবে রাখে: কোনো ক্লাউড API নেই, অ্যাকাউন্ট নেই এবং কোনো প্রম্পট বা টুল কন্টেন্ট সংরক্ষণ করা হয় না। এটির শুধু ঐচ্ছিক বিজ্ঞপ্তির অনুমতি প্রয়োজন, এবং এটি Full Disk Access চায় না কারণ এর উৎসগুলো হলো স্থানীয় ডটফাইল ও application support ফাইল। Vole Claude Code, OpenCode, Codex CLI, Grok CLI, Cursor, Devin এবং Antigravity সহ বিভিন্ন টুল সমর্থন করে। এটি ডেটা নিশ্চয়তার স্তর আলাদা করে: টুল লগ থেকে সরাসরি পড়া সঠিক মান, নথিভুক্ত পদ্ধতিসহ নির্ধারিত অনুমান, এবং যখন কোনো টুল শুধু একটি কল হয়েছে বলে রেকর্ড করে কিন্তু টোকেন মাপার মতো যথেষ্ট বিবরণ থাকে না তখন কার্যকলাপ-শুধু সারি। মোট পরিসংখ্যানে কোন স্তরগুলো অন্তর্ভুক্ত করা হয়েছে তা বলা থাকে এবং অজানা মডেল অনুমান না করে NULL ফেরত দেয়। ড্যাশবোর্ডে প্রধান টোকেন ও খরচের সংখ্যা, একটি স্পার্কলাইন, প্রতি-টুল বার এবং ঘটনা-টীকাযুক্ত টাইমলাইন থাকে। টাইমলাইন টুল অনুযায়ী টোকেন স্তূপ করে এবং ঘটনা চিহ্নিত করে, ফলে স্পাইক ও তাদের কারণ পরীক্ষা করা সহজ হয়। মেনু-বার আইটেম লাইভ টোকেন, খরচ বা শুধু একটি স্ট্যাটাস চিহ্ন দেখাতে পারে এবং কোনো ঘটনা সক্রিয় থাকা অবস্থায় রঙিন থাকে। অসঙ্গতি শনাক্তকরণে বিলযোগ্য ব্যয় স্পাইক, পুনরাবৃত্ত কল লুপ, ত্রুটি-ঝড়, rate-limit চাপ এবং context চাপের নিয়ম অন্তর্ভুক্ত থাকে। বেসলাইনগুলো leave-one-out তুলনা ব্যবহার করে, যাতে একটি একক স্পাইক তার নিজের বেসলাইনের মধ্যে লুকিয়ে না যায়। লুপ শনাক্তকরণ মিথ্যা ইতিবাচক ফলাফল কমাতে কলের পরিমাণের সঙ্গে সমতল আউটপুট এবং বাড়তে থাকা ক্যাশে রিডকে যুক্ত করে। খরচ গণনা করা হয় সাবস্ক্রিপশন বিলিং নয়, তালিকা মূল্যে সমতুল্য API মূল্য হিসেবে। মূল্যহারগুলো সংস্করণকৃত ডেটা হিসেবে সংরক্ষিত থাকে, প্রতি ইনস্টলেশনে ওভাররাইড করা যায় এবং অজানা মডেলগুলো null রাখা হয়। একটি verification কমান্ড উৎস রেকর্ড থেকে সংরক্ষিত সারিগুলো স্বাধীনভাবে পুনরায় নির্ধারণ করে মূল্য বা পার্সিং বাগ ধরতে সাহায্য করে। প্রকল্পটিতে লাইভ সেশন, ডাইজেস্ট, PR ব্যবহার টেবিল, স্ট্যাটাস লাইন, অপ্টিমাইজেশন ফাইন্ডিং, বাজেট ক্যাপ, মডেল দক্ষতা এবং স্বাস্থ্য পরীক্ষার জন্য CLI কমান্ডও রয়েছে। একটি MCP সার্ভার একই স্থানীয় ডেটা এজেন্টদের কাছে প্রকাশ করে, যার ফলে কোনো এজেন্ট তার নিজের সেশন খরচ, context ব্যবহার এবং ঘটনার স্ট্যাটাস জিজ্ঞাসা করতে পারে। সমর্থিত হুক উপলব্ধ থাকলে তার মাধ্যমে বাজেট ক্যাপ প্রয়োগ করা যায়, আর হুক সমর্থন নেই এমন টুলের ক্ষেত্রে তা পরামর্শমূলক থাকে। পরিচিত সীমাবদ্ধতার মধ্যে রয়েছে Devin ও Antigravity-র জন্য সীমিত স্থানীয় টোকেন ডেটা, আংশিকভাবে নির্ধারিত Cursor বার্তার সময়, Cursor-এ সাম্প্রতিক স্থানীয় টোকেন গণনার অভাব, শুধু API-ভিত্তিক ত্রুটি কভারেজ, কিছু টুলের জন্য নিম্ন-সীমা জেনারেশন গতি এবং শুধুমাত্র ফার্স্ট-পার্টি মডেল ID-র জন্য context-উইন্ডো রেজোলিউশন।