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

ENDMEMEX คือ memory และ coordination layer สำหรับ Claude Code และ Codex — ต่างจาก AI agent ที่ทำงานให้ผู้ใช้โดยตรง มันเป็นเครื่องมือสำหรับนักพัฒนาที่ต้องการให้ agent จำบริบทโครงการข้าม session และมอบหมายงานย่อยให้ agent อื่นอย่างมีขอบเขต
สองแกนหลักของ ENDMEMEX
- ความจำต่อเนื่องของโครงการ — เก็บความรู้, record, session และ checkpoint เพื่อให้ session หรือ agent ถัดไปทำงานต่อได้โดยไม่ต้องอธิบายสิ่งเดิมซ้ำ
- การสั่งการ sub-agent — เริ่ม, ติดตาม และยกเลิกงานย่อยของ Codex, Claude หรือ Antigravity ผ่าน run ที่มีเป้าหมาย, role และ timeout ชัดเจน
สองแกนนี้ทำงานร่วมกัน: memory ให้บริบทที่ถูกต้องก่อนเริ่มงาน ส่วน coordination ช่วยแบ่งงานตรวจสอบ วิเคราะห์ หรือแก้ไขเป็นชิ้นที่ควบคุมและติดตามได้ แทนการปล่อยให้หลาย agent ทำงานทับกันแบบไร้ร่องรอย
แก้ปัญหาอะไร
เวลาทำงานกับ 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)
- การมอบหมายงานย่อยแบบ bounded — เริ่ม sub-agent, poll สถานะหรือผลบางส่วน, และยกเลิก run ได้ โดยกำหนด role เป็น worker, reviewer หรือ advisor
ไฟล์ 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
MCP tools: 7 กลุ่มตามหน้าที่
เมื่อใช้ผ่าน MCP (เช่นใน Codex หรือ Claude Code) ENDMEMEX เปิดเป็น 7 tools แบ่งตามโดเมน แต่ละตัวเลือกงานด้วย argument action แทนการมี tool แยกเป็นสิบกว่าตัว ส่วน CLI ยังใช้คำสั่งเดิมได้ตามปกติ
| Tool | action ที่เลือกได้ |
ใช้ทำอะไร |
|---|---|---|
endmemex_context |
bootstrap, readiness, pack, pending, handoff, timeline, sync_status |
เริ่มงาน/ดูภาพรวมโดยอ่านอย่างเดียว |
endmemex_search |
query, record_search, record_show |
ค้นความจำและ record |
endmemex_records |
add, update, link, feedback |
บันทึก/แก้ข้อเท็จจริงถาวรและความสัมพันธ์ |
endmemex_session |
checkpoint, pin, unpin, close |
ส่งต่องานและปิด session |
endmemex_events |
poll, ack |
รับ/ยืนยัน event จากงานเบื้องหลัง |
endmemex_presence |
list, start, heartbeat, stop |
ประกาศว่าใครทำงานอยู่ (opt-in) |
endmemex_admin |
initialize, embed_backfill |
เริ่มต้น/migrate ฐานข้อมูลและ backfill embeddings (งานเขียน ใช้เมื่อ bootstrap สั่งเท่านั้น) |
ตัวอย่าง: endmemex_context(action="bootstrap") ก่อนเริ่มงาน, endmemex_search(action="query", ...) ก่อนทำซ้ำสิ่งที่เคยทำ และ endmemex_session(action="checkpoint", ...) หลังแต่ละช่วงงานที่สำคัญ
เอกสารเชิงลึก
README เป็นจุดเริ่มต้นสั้นๆ เท่านั้น — คำสั่ง, flag, payload และตัวอย่างแบบละเอียดอยู่ใน ENDMEMEX_USER_MANUAL.md ของ repo ให้เปิดเฉพาะหัวข้อที่ต้องใช้จริง ไม่ต้องอ่านทั้งไฟล์
การสั่งงาน sub-agent เป็น trust boundary แยกจาก memory server โดยเจตนา: reviewer/advisor เป็น read-only เสมอ ส่วน worker จะเขียนได้ก็ต่อเมื่อระบุสิทธิ์ที่เหมาะสมอย่างชัดเจน ดูรายละเอียดในคู่มือ Spawn Agent
ความคิดเห็น
กำลังโหลดความคิดเห็น...