CodeAlmanac - AI कोडिंग एजेंट्स के लिए कोडबेस Wiki

 (github.com/AlmanacCode)
3 पॉइंट द्वारा xguru 2 시간 전 | अभी कोई टिप्पणी नहीं है. | WhatsApp पर शेयर करें
  • सिर्फ code में न समा पाने वाले निर्णय, flow, invariants, pitfalls (gotchas) को दर्ज करके AI एजेंट्स को context देने वाला living wiki
    • यह दर्ज करता है कि system अभी इस रूप में क्यों है, अतीत में क्या टूटा था, और workflow files/services के आर-पार कैसे चलता है
  • Wiki repository के अंदर Markdown files के रूप में stored रहता है, और local indexing के बाद code की तरह Git में review किया जा सकता है
  • एजेंट्स और इंसान एक ही local read commands इस्तेमाल करते हैं: search, show, topics, health, validate
    • search --mentions src/checkout/ file path के आधार पर search support करता है, --wiki <name> से दूसरे wiki को query किया जा सकता है
  • Wiki को लगातार update करने वाले lifecycle tasks तीन स्पष्ट एजेंट्स—build / ingest / garden—से चलते हैं
    • अलग से प्रकाशित Yoke SDK का उपयोग
    • ingest: files, directories, Git diff, commit ranges, GitHub PR/issues, URLs, local agent transcripts को wiki में integrate करता है
    • garden: पुराने pages, कमजोर links, topics, duplicate pages आदि की सफाई करता है
  • maintenance commands याद न रखनी पड़ें, इसके लिए local macOS launchd background jobs के 3 प्रकार दिए गए हैं
    • Sync (हर 5 घंटे): हाल की Codex/Claude conversations scan करके relevant wiki में ingest task के तौर पर queue करता है
    • Garden (हर 24 घंटे): registered सभी wikis में पुराना/duplicate/खराब connected knowledge review करता है
    • Update (हर 24 घंटे): केवल सुरक्षित समय पर CLI auto-update करता है; lifecycle tasks चल रहे हों तो skip करता है
  • hosting service या cloud sync नहीं, बल्कि पूरी तरह local execution; logs ~/.codealmanac/logs/ में stored होते हैं
  • execution history local job records के रूप में रहती है, इसलिए terminal बंद करने के बाद भी query की जा सकती है
    • jobs, jobs show, jobs logs, jobs attach, jobs cancel
    • --json से scripts के साथ integration संभव
  • Provider almanac-yoke को single entry point के रूप में इस्तेमाल करता है; Codex app-server और Claude Python Agent SDK इस्तेमाल करता है
    • मौजूदा Codex/Claude Code OAuth sessions reuse
  • serve से खुलने वाला local viewer read-only है; pages/search/topics/backlinks/file reference navigation render करता है
  • lifecycle agents व्यापक non-interactive filesystem permissions के साथ operate करते हैं
    • almanac/ folder OS sandbox नहीं, बल्कि instructions/commit policy है, इसलिए इसे केवल trusted repositories में ही चलाना चाहिए
  • telemetry optional है। code/paths/prompts/transcripts/credentials भेजे नहीं जाते, GeoIP disabled है, और DO_NOT_TRACK=1 से भी block किया जा सकता है
  • Apache-2.0 license

संबंधित पढ़ाई

अभी कोई टिप्पणी नहीं है.

अभी कोई टिप्पणी नहीं है.