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

lore হলো একটি লোকাল কমান্ড লাইন টুল এবং ওয়েব এক্সপ্লোরার যা একটি মেশিনে Claude Code-এর লেখা সমস্ত কিছুর জন্য ব্যবহৃত হয়। Claude Code একটি ডেটা ডিরেক্টরির অধীনে সেশন ট্রান্সক্রিপ্ট, মেমোরি এবং প্রম্পট হিস্ট্রি রাখে, যা প্রজেক্ট অনুযায়ী ভাগ করা থাকে এবং এর ডিফল্ট রিটেনশন পলিসি প্রায় ৩০ দিন পর ট্রান্সক্রিপ্টগুলো মুছে ফেলে। lore সেই র ডেটার একটি অ্যাডিটিভ মিরর রাখে, সেটিকে ইনডেক্স করে এবং নিজস্ব সেশন হিস্ট্রির ওপর একটি কুয়েরি সারফেস প্রদান করে। ইনস্টলেশন এবং প্ল্যাটফর্ম: এই প্রজেক্টের জন্য শুধুমাত্র Bun প্রয়োজন, কোনো rsync বা টুলচেইন ডিপেন্ডেন্সি নেই। এর কন্টিনিউয়াস ইন্টিগ্রেশন টেস্ট স্যুট রান করে এবং macOS, Linux এবং Windows-এ বাইনারি ইনস্টল করে। এক্সপ্লোরারসহ সমস্ত ভার্ব তিনটি প্ল্যাটফর্মেই কাজ করে। একমাত্র ব্যতিক্রম হলো lore সার্ভার সুপারভাইজার, যা একটি launchd ইউজার এজেন্টের মাধ্যমে ব্যাকগ্রাউন্ডে এক্সপ্লোরার চালু রাখে, তাই এটি শুধুমাত্র macOS-এর জন্য এবং অন্য ক্ষেত্রে ব্যবহারকারীদের lore serve-এর পরামর্শ দেয়। ইনস্টল স্ক্রিপ্টটি একটি ফ্রোজেন বাইনারি তৈরি করে, ডার্টি ওয়ার্কিং ট্রি প্রত্যাখ্যান করে এবং প্রতিটি ইনভোকেশন stderr-এ এর ভার্সন এবং কমিট রিপোর্ট করে। একটি harness-corpus স্ক্রিপ্ট Claude Code আপডেটের পর ডেমনের শেপগুলোকে টেস্ট ফিক্সচারে স্ন্যাপশট করে। ডেটা মডেল এবং ইনডেক্সিং: একটি well হলো Claude প্রজেক্টস পাথের অধীনে একটি ডিরেক্টরির স্টোর, যা এর অ্যাবসলিউট পাথ থেকে নামকরণ করা হয় যেখানে নন-অ্যালফানিউমেরিক ক্যারেক্টারগুলো ফ্ল্যাটেন করা হয়, তাই এই নামকরণ লসি (lossy)। প্রতিটি সেশন একটি চ্যাট লগের পরিবর্তে JSONL ইভেন্ট লগ, যা মূলত টুল ট্রাফিক, থিংকিং এনভেলপ এবং হারনেস ইভেন্টের পাশাপাশি সাব-এজেন্ট ট্রান্সক্রিপ্ট এবং ওয়ার্কফ্লো স্ক্রিপ্ট নিয়ে গঠিত। index কমান্ড well-গুলো স্ক্যান করে, JSONL পার্স করে এবং মডিফিকেশন টাইম ও সাইজ অনুযায়ী ইনক্রিমেন্টালি spawns এবং workflows লেনের সাথে একটি SQLite FTS5 ইনডেক্স তৈরি করে। ইনডেক্সটি একটি ডেরাইভড, রিবিল্ডেবল আর্টিফ্যাক্ট যা মাইগ্রেশনের পরিবর্তে ভার্সন-বাম্প করে এবং নতুনer lore দ্বারা লেখা ডেটাবেস খুলতে অস্বীকার করে। কমান্ডসমূহ: archive কমান্ড Claude ডেটা ডিরেক্টরিকে lore আর্কাইভে মিরর করে কিন্তু আপস্ট্রিম ডিলিটগুলো প্রোপাগেট করে না; wells ডি-স্লাগড রিয়েল পাথ এবং ফ্ল্যাগসহ স্টোরগুলোর তালিকা দেখায়; sessions এবং session একটি well-এর ক্রনোলজিক্যাল আর্ক দেখায় অথবা লেন অনুযায়ী একটি সেশন ডাম্প করে; search লেনের আড়ালে FTS5 কুয়েরি করে এবং এতে প্রম্পট হিস্ট্রি স্পাইন অন্তর্ভুক্ত থাকতে পারে; spawns প্রতি সাব-এজেন্ট মডেলের ভেরিফাইড বনাম রিকোয়েস্টেড রিপোর্ট করে সাথে ড্রিফট ফ্ল্যাগ এবং বুট কস্ট দেখায়; workflows অর্কেস্ট্রেশন রানগুলোর সারাংশ প্রদান করে; polls সেই সেশনগুলোকে ফ্ল্যাগ করে যা প্রতি টার্নে একটি ব্যাকগ্রাউন্ড টাস্ক আউটপুট ফাইল পুনরায় পড়ে, যা প্রাইসড; tools টুল, স্কিল এবং কমান্ড ইনভোকেশন গণনা করে; usage well, সেশন, মডেল, দিন, সপ্তাহ বা মাস অনুযায়ী বিলড টোকেন ক্লাস এবং থিংকিং প্রোফাইল করে, সাথে একটি ডেটেড লিস্ট-প্রাইস ইকুইভ্যালেন্ট থাকে; trace একটি সেশনকে ট্রানজ্যাকশন, স্টেপ, টুল কল এবং অ্যানোটেশন হিসেবে রেন্ডার করে; agents লাইভ রোস্টারকে ইনডেক্সের সাথে যুক্ত করে; stats কর্পাস টোটাল, লেন এবং ওয়ার্নিং রিপোর্ট করে। প্রতিটি কমান্ড হেল্প আউটপুট সাপোর্ট করে এবং অনেক কমান্ড সাবস্ট্রিং ম্যাচিং সহ একটি well ফিল্টার এবং এক্স্যাক্ট হোল-ভ্যালু ম্যাচিংয়ের জন্য একটি ফ্ল্যাগ গ্রহণ করে। এক্সপ্লোরার: lore serve ইনডেক্সটিকে সাম্প্রতিক সেশন এবং well, টোকেন ব্যবহার, ইন্ডিভিজুয়াল well এবং সেশন, সার্চ রেজাল্ট এবং কমিট মেসেজে লেখা সেশন ট্রেইলারের জন্য সার্ভার-রেন্ডারড HTML পেজ হিসেবে রেন্ডার করে। প্রতিটি পেজ JSON-এর উত্তর দিতে পারে, রিড ভার্বগুলো একটি OpenAPI স্পেকসহ কমান্ড পাথের অধীনে মাউন্ট করা থাকে এবং api ভার্ব কমান্ডগুলোর মতোই হ্যান্ডলার এক্সপোজ করে। ডিফল্ট পোর্ট হলো 4949 এবং হোস্ট অপশনগুলো বাইন্ডিং কন্ট্রোল করে, যার মধ্যে Tailscale অ্যাড্রেস অন্তর্ভুক্ত থাকে যদি তা বিদ্যমান থাকে। জাজমেন্ট লেয়ার: ডিটারমিনিস্টিক, মডেল-মুক্ত CLI-এর উপরে একটি অপশনাল উইকি ওয়ার্কফ্লো থাকে। wiki init একটি বিল্ট-ইন টেমপ্লেট থেকে মার্কডাউনের একটি git রিপোজিটরি তৈরি করে এবং skills add প্রতি-কমান্ড স্কিল ইনস্টল করে যাতে Claude Code সেশনগুলো CLI খুঁজে পায়। উইকিতে র মেটেরিয়াল ইনজেস্ট করা, উইকি পেজগুলোকে git-কমিটেড ডকসে উন্নীত করা এবং পুরনো ক্যাননের জন্য লিন্টিং করা হলো প্রোটোকল যা একটি ইন্টারঅ্যাক্টিভ Claude সেশন CLI চালনার মাধ্যমে সম্পাদন করে; এগুলো কমান্ড হিসেবে শিপ করার পরিবর্তে ডিজাইন নোটে ডকুমেন্ট করা হয়েছে, তাই টুলটির কোনো API কি-র প্রয়োজন নেই। একটি docs ভার্ব রিপোজিটরিতে কমিট করা মার্কডাউন ইনডেক্স করে, যা ওয়ার্কিং ট্রির পরিবর্তে git অবজেক্ট থেকে পড়া হয়। ডেটা হ্যান্ডলিং: এটি Claude ডেটা ডিরেক্টরি এবং ডকসের জন্য কোড রুটের অধীনে git অবজেক্ট স্টোর পড়ে; এটি lore হোম ডিরেক্টরি, একটি অপশনাল উইকি রিপো এবং শুধুমাত্র macOS সুপারভাইজারের জন্য একটি launchd plist লেখে। ডকস ইনডেক্সিংয়ের জন্য অনুরোধ করা হলে একটি এক্সপ্লিসিট git fetch এবং এক্সপ্লোরার যে পোর্টে লিসেন করে তা ছাড়া কোনো নেটওয়ার্ক অ্যাক্টিভিটি নেই; কিছুই আপলোড করা হয় না এবং কোনো মডেল কল, টেলিমেট্রি বা অ্যাকাউন্ট নেই। কনফিগারেশন ভ্যালিডেটেড এনভায়রনমেন্ট ভেরিয়েবলের মাধ্যমে করা হয় যেমন Claude dir, lore home, code dir, wiki dir এবং docs exclude এবং assisted লিস্ট। একটি আলাদা ডিপেন্ডেন্সি-মুক্ত Python স্ক্রিপ্ট সরাসরি ট্রান্সক্রিপ্ট JSONL পড়ে এবং কারণ এবং সেশনের পরবর্তী পদক্ষেপ অনুযায়ী ডিনাইড টুল কল রিপোর্ট করে, সাথে একটি রানবুক থাকে যা বর্ণনা করে কীভাবে সেগুলো রিভিউ করতে হবে। স্ট্যাটাস: এটি একটি প্রাথমিক ব্যক্তিগত টুল যা MIT লাইসেন্সের অধীনে 'as-is' এবং শুধুমাত্র লোকাল ব্যবহারের জন্য পাবলিশ করা হয়েছে, এটিকে কোনো প্রোডাক্টে পরিণত করার পরিকল্পনা নেই।