इस प्रोजेक्ट के बारे में

lore एक स्थानीय कमांड लाइन टूल और वेब एक्सप्लोरर है जो मशीन पर Claude Code द्वारा लिखे गए हर विवरण के लिए है। Claude Code सत्र ट्रांसक्रिप्ट, मेमोरी और प्रॉम्प्ट हिस्ट्री को एक डेटा डायरेक्टरी के तहत रखता है, जो प्रति प्रोजेक्ट शार्ड किया गया होता है, और इसका डिफॉल्ट रिटेंशन लगभग 30 दिनों के बाद ट्रांसक्रिप्ट को हटा देता है। lore उस रॉ डेटा का एक एडिटिव मिरर रखता है, उसे इंडेक्स करता है, और अपनी सत्र हिस्ट्री पर एक क्वेरी सरफेस प्रदान करता है। इंस्टॉल और प्लेटफॉर्म: इस प्रोजेक्ट के लिए केवल Bun की आवश्यकता है, किसी rsync या टूलचेन डिपेंडेंसी की नहीं। इसका कंटीन्यूअस इंटीग्रेशन टेस्ट सूट चलाता है और macOS, Linux और Windows पर बाइनरी इंस्टॉल करता है। एक्सप्लोरर सहित सभी वर्ब्स तीनों प्लेटफॉर्म पर काम करते हैं। अपवाद lore सर्वर सुपरवाइजर है, जो launchd यूजर एजेंट के माध्यम से एक्सप्लोरर को बैकग्राउंड में चालू रखता है, इसलिए यह केवल macOS के लिए है और अन्यथा उपयोगकर्ताओं को lore serve की ओर निर्देशित करता है। इंस्टॉल स्क्रिप्ट एक फ्रोजन बाइनरी बनाती है, गंदे वर्किंग ट्री को अस्वीकार करती है, और हर इनवोकेशन stderr पर अपना वर्जन और कमिट रिपोर्ट करता है। एक harness-corpus स्क्रिप्ट Claude Code अपडेट के बाद डेमन के शेप्स को टेस्ट फिक्स्चर में स्नैपशॉट करती है। डेटा मॉडल और इंडेक्सिंग: एक 'well' Claude प्रोजेक्ट्स पाथ के तहत एक डायरेक्टरी स्टोर है, जिसका नाम उसके एब्सोल्यूट पाथ से लिया गया है जिसमें नॉन-अल्फ़ान्यूमेरिक कैरेक्टर्स को फ्लैट कर दिया गया है, इसलिए नामकरण लॉसि (lossy) है। प्रत्येक सत्र चैट लॉग के बजाय एक JSONL इवेंट लॉग है, जिसमें मुख्य रूप से टूल ट्रैफिक, थिंकिंग एनवेलप्स और हार्नेस इवेंट्स होते हैं, साथ ही सिबलिंग सब-एजेंट ट्रांसक्रिप्ट और वर्कफ़्लो स्क्रिप्ट्स होते हैं। index कमांड wells को स्कैन करता है, JSONL को पार्स करता है और मॉडिफिकेशन टाइम और साइज के आधार पर इंक्रीमेंटली spawns और workflows लेन्स के साथ एक SQLite FTS5 इंडेक्स बनाता है। इंडेक्स एक व्युत्पन्न (derived), पुनर्रचना योग्य आर्टिफैक्ट है जो माइग्रेट करने के बजाय वर्जन-बम्प करता है और नए lore द्वारा लिखे गए डेटाबेस को खोलने से इनकार करता है। कमांड्स: archive बिना अपस्ट्रीम डिलीशन के Claude डेटा डायरेक्टरी को lore आर्काइव में मिरर करता है; wells डी-स्लग किए गए वास्तविक पाथ और फ्लैग्स के साथ स्टोर्स को सूचीबद्ध करता है; sessions और session एक well के कालानुक्रमिक आर्क को देखते हैं या एक सत्र को लेन के आधार पर डंप करते हैं; search लेन्स में FTS5 क्वेरी करता है और इसमें प्रॉम्प्ट हिस्ट्री स्पाइन शामिल हो सकता है; spawns प्रति-सब-एजेंट मॉडल के लिए वेरिफाइड बनाम रिक्वेस्टेड रिपोर्ट करता है जिसमें ड्रिफ्ट फ्लैग्स और बूट कॉस्ट होते हैं; workflows ऑर्केस्ट्रेशन रन्स का सारांश देता है; polls उन सत्रों को फ्लैग करता है जो हर टर्न में बैकग्राउंड टास्क आउटपुट फ़ाइल को फिर से पढ़ते हैं, जिसकी कीमत तय होती है; tools टूल, स्किल और कमांड इनवोकेशन्स की गिनती करता है; usage वेल, सत्र, मॉडल, दिन, सप्ताह या महीने के आधार पर बिल किए गए टोकन क्लासेस और थिंकिंग की प्रोफाइलिंग करता है, जिसमें डेटेड लिस्ट-प्राइस समकक्ष होता है; trace एक सत्र को ट्रांजेक्शन, स्टेप्स, टूल कॉल्स और एनोटेशन के रूप में रेंडर करता है; agents लाइव रोस्टर को इंडेक्स के साथ जोड़ता है; stats कॉर्पस टोटल, लेन्स और चेतावनियों की रिपोर्ट करता है। हर कमांड हेल्प आउटपुट का समर्थन करता है, और कई कमांड एक well फ़िल्टर स्वीकार करते हैं जो सबस्ट्रिंग्स से मेल खाता है साथ ही सटीक होल-वैल्यू मैचिंग के लिए एक फ्लैग होता है। एक्सप्लोरर: lore serve इंडेक्स को हाल के सत्रों और wells, टोकन उपयोग, व्यक्तिगत wells और सत्रों, खोज परिणामों और कमिट संदेशों में लिखे गए सत्र ट्रेलर्स के लिए सर्वर-रेंडर 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 लाइसेंस के तहत, जिसे उत्पाद बनाने की कोई योजना नहीं है।