CodeAlmanac - Wiki codebase cho tác nhân lập trình AI

• Ghi lại các quyết định, luồng xử lý, điều kiện bất biến và cạm bẫy (gotchas) mà chỉ code thôi không thể chứa đựng, để cung cấp ngữ cảnh cho tác nhân AI dưới dạng một wiki sống
  • Ghi lại vì sao hệ thống có hình dạng như hiện tại, trước đây điều gì đã hỏng, và workflow đi xuyên qua các file/dịch vụ như thế nào
• Wiki được lưu dưới dạng tệp Markdown trong repository, có thể lập chỉ mục cục bộ rồi review trên Git như code
• Tác nhân và con người dùng cùng một tập lệnh đọc cục bộ: search, show, topics, health, validate
  • Hỗ trợ tìm kiếm theo đường dẫn tệp với search --mentions src/checkout/, có thể xem wiki khác bằng --wiki <name>
• Các tác vụ vòng đời để liên tục cập nhật wiki được chạy bằng ba tác nhân tường minh: build / ingest / garden
  • Sử dụng Yoke SDK được công khai riêng
  • ingest: hợp nhất file, thư mục, Git diff, phạm vi commit, GitHub PR/issue, URL và transcript tác nhân cục bộ vào wiki
  • garden: dọn dẹp các trang cũ, liên kết yếu, topic, trang trùng lặp, v.v.
• Cung cấp 3 loại tác vụ nền launchd cục bộ trên macOS để không cần phải nhớ các lệnh bảo trì
  • Sync (mỗi 5 giờ): quét các cuộc trò chuyện Codex/Claude gần đây và đưa vào hàng đợi ingest cho wiki liên quan
  • Garden (mỗi 24 giờ): rà soát kiến thức cũ/trùng lặp/kết nối kém của mọi wiki đã đăng ký
  • Update (mỗi 24 giờ): chỉ tự động cập nhật CLI vào thời điểm an toàn, bỏ qua khi các tác vụ vòng đời đang chạy
• Chạy hoàn toàn cục bộ, không phải dịch vụ hosting hay đồng bộ đám mây; log được lưu tại ~/.codealmanac/logs/
• Lịch sử chạy được lưu thành bản ghi job cục bộ, nên vẫn có thể tra cứu ngay cả khi đã đóng terminal
  • jobs, jobs show, jobs logs, jobs attach, jobs cancel
  • Có thể tích hợp script bằng --json
• Provider dùng almanac-yoke làm đầu mối duy nhất; Codex dùng app-server, Claude dùng Python Agent SDK
  • Tái sử dụng phiên OAuth hiện có của Codex/Claude Code
• Trình xem cục bộ khởi chạy bằng serve là chỉ đọc, hiển thị điều hướng theo trang/tìm kiếm/topic/backlink/tham chiếu file
• Các tác nhân vòng đời hoạt động với quyền truy cập filesystem phi tương tác trên diện rộng
  • Thư mục almanac/ không phải sandbox của OS mà là chính sách chỉ dẫn/commit, nên chỉ nên chạy trong repository đáng tin cậy
• Telemetry là tùy chọn. Không gửi code/đường dẫn/prompt/transcript/thông tin xác thực, GeoIP bị vô hiệu hóa, và cũng có thể chặn bằng DO_NOT_TRACK=1
• Giấy phép Apache-2.0