เริ่มต้นใช้งาน ENDMEMEX

ENDMEMEX คือ local SQLite knowledge, durable-record และ resumable checkpoint store สำหรับ Claude Code และ Codex — ต่างจาก 3 ตัวข้างต้นที่เป็น AI agent สำหรับผู้ใช้ทั่วไป ENDMEMEX เป็นเครื่องมือสำหรับนักพัฒนาที่ใช้ AI coding agent เพื่อแก้ปัญหา agent ลืมบริบทของโปรเจกต์ทุกครั้งที่เริ่ม session ใหม่

แก้ปัญหาอะไร

เวลาทำงานกับ Claude Code หรือ Codex ข้ามหลาย session ปัญหาที่พบบ่อยคือ agent ไม่รู้ว่าตัวเองเคยทำอะไรไปแล้ว ต้องอธิบายบริบทซ้ำทุกครั้ง ENDMEMEX เก็บ:

• เนื้อหาที่ค้นหาได้ จาก Markdown ที่ track ไว้ พร้อม path, heading, provenance และการค้นแบบ lexical/semantic
• Session และ checkpoint ที่แชร์กันได้ — งานที่ทำเสร็จ สถานะปัจจุบัน ขั้นต่อไป จุดติดขัด ไฟล์ที่แก้ คำสั่งที่ใช้ และผลตรวจสอบ
• Record แบบถาวร สำหรับ audit, fix, verification, decision และ knowledge เชื่อมกันด้วยความสัมพันธ์แบบมี lifecycle
• ประวัติกิจกรรม และ agent presence (แบบ opt-in)

ไฟล์ Markdown ยังเป็นแหล่งความจริงหลักที่มนุษย์อ่านได้ — SQLite เป็นชั้นค้นหาต่อเนื่องที่ทับซ้อนอยู่ด้านบน

เริ่มต้นใช้งาน

รันจาก repository root ของโปรเจกต์ที่จะใช้ ครั้งแรกให้ initialize และติดตั้ง pre-commit hook:

python3 endeavor_db.py init
python3 endeavor_db.py install-hooks

ก่อนเริ่มงานที่ไม่ใช่งานเล็กน้อย ให้ bootstrap โปรเจกต์ที่เลือกไว้ครั้งเดียว:

python3 endeavor_db.py bootstrap --project <PROJECT> --json

bootstrap จะคืนค่า handoff ที่ทำต่อได้ (null คือสถานะว่างปกติ), รัน embedding backfill แบบ best-effort, และรายงานความสดใหม่ของเอกสารที่ track ไว้

ตรวจงานค้างก่อนเริ่ม session

ก่อนถามหางานค้างหรือ backlog ให้ใช้ลำดับนี้เสมอ (ไม่ใช่ไล่ดู Git หรือค้นไฟล์เอง):

python3 endeavor_db.py pending --all-projects --json
python3 endeavor_db.py handoff --all-paused --json

pending บอกทุกโปรเจกต์ที่มี session ค้างอยู่ ส่วน handoff คือคิวงานที่ทำต่อได้แบบ authoritative — ต้องนำเสนอให้ผู้ใช้เลือกเอง ห้าม agent เลือก session ที่จะทำต่อเอง

ค้นความรู้ในโปรเจกต์

python3 endeavor_db.py query "<คำถาม>" --project <PROJECT> --json --compact

ใช้ก่อนจะขุดหาความรู้เก่าซ้ำ หรือก่อนตัดสินใจอะไรที่กระทบวงกว้าง

กติกาที่ต้องรู้ก่อนใช้

• เก็บ endeavor_memory.sqlite3 ที่เขียนได้ไว้บนเครื่องเดียวเท่านั้น — ห้ามวางไว้ใน iCloud, Dropbox หรือ filesystem sync service อื่น (SQLite WAL รองรับ concurrent process ได้เฉพาะบนเครื่องเดียวกัน)
• การเขียนข้ามเครื่องต้องผ่าน write_gateway.py ที่ยืนยันตัวตนแล้วเท่านั้น ห้ามพยายามทำ distributed SQLite ผ่านโฟลเดอร์ที่แชร์กัน
• ห้ามเก็บ token, password, private key, ค่า environment ลับ หรือ log ดิบขนาดใหญ่ไว้ใน checkpoint หรือ record
• Checkpoint หลังจบแต่ละ phase สำคัญ ไม่ใช่แค่ตอนจบงาน และแจ้งผู้ใช้ทุกครั้งที่บันทึกสำเร็จ

ดูคำสั่งทั้งหมดแบบเร็ว

python3 endeavor_db.py agent-help

เอกสารเชิงลึก

README เป็นจุดเริ่มต้นสั้นๆ เท่านั้น — คำสั่ง, flag, payload และตัวอย่างแบบละเอียดอยู่ใน ENDMEMEX_USER_MANUAL.md ของ repo ให้เปิดเฉพาะหัวข้อที่ต้องใช้จริง ไม่ต้องอ่านทั้งไฟล์

ดูเพิ่มเติม

ซอร์สโค้ดและเอกสารฉบับเต็มบน GitHub