CodeAlmanac - Wiki codebase untuk agen coding AI

• Wiki hidup yang mencatat keputusan, alur, invariant, dan jebakan (gotchas) yang tidak bisa ditampung hanya oleh kode, untuk menyediakan konteks bagi agen AI
  • Mencatat mengapa sistem berbentuk seperti sekarang, apa yang pernah rusak di masa lalu, dan bagaimana workflow melintasi file/layanan
• Wiki disimpan sebagai file Markdown di dalam repository, dan setelah indexing lokal dapat direview di Git seperti kode
• Agen dan manusia menggunakan perintah baca lokal yang sama: search, show, topics, health, validate
  • Mendukung pencarian berdasarkan path file dengan search --mentions src/checkout/, dan dapat melihat wiki lain dengan --wiki <name>
• Pekerjaan lifecycle untuk terus memperbarui wiki dijalankan oleh tiga agen eksplisit: build / ingest / garden
  • Menggunakan Yoke SDK yang dirilis terpisah
  • ingest: mengintegrasikan file, direktori, Git diff, rentang commit, PR/issue GitHub, URL, dan transkrip agen lokal ke dalam wiki
  • garden: merapikan halaman usang, link lemah, topik, halaman duplikat, dan lainnya
• Menyediakan 3 jenis background job macOS launchd lokal agar tidak perlu mengingat perintah maintenance
  • Sync(setiap 5 jam): memindai percakapan Codex/Claude terbaru dan mengantrekannya sebagai pekerjaan ingest ke wiki terkait
  • Garden(setiap 24 jam): meninjau pengetahuan yang usang/duplikat/koneksi lemah di semua wiki terdaftar
  • Update(setiap 24 jam): memperbarui CLI secara otomatis hanya pada saat yang aman; dilewati jika pekerjaan lifecycle sedang berjalan
• Bukan layanan hosting atau sinkronisasi cloud, melainkan berjalan sepenuhnya lokal; log disimpan di ~/.codealmanac/logs/
• Riwayat eksekusi tersimpan sebagai record job lokal sehingga tetap dapat dilihat meski terminal ditutup
  • jobs, jobs show, jobs logs, jobs attach, jobs cancel
  • Dapat diintegrasikan dengan skrip melalui --json
• Provider menggunakan almanac-yoke sebagai satu pintu; Codex memakai app-server, Claude memakai Python Agent SDK
  • Menggunakan ulang sesi OAuth Codex/Claude Code yang sudah ada
• Viewer lokal yang dijalankan dengan serve bersifat read-only, merender navigasi halaman/pencarian/topik/backlink/referensi file
• Agen lifecycle beroperasi dengan izin filesystem non-interaktif yang luas
  • Folder almanac/ adalah kebijakan instruksi/commit, bukan sandbox OS, sehingga perlu dijalankan hanya pada repository tepercaya
• Telemetri bersifat opsional. Kode/path/prompt/transkrip/kredensial tidak dikirim, GeoIP dinonaktifkan, dan juga dapat diblokir dengan DO_NOT_TRACK=1
• Lisensi Apache-2.0