Hypomnema - wiki cá nhân native cho LLM chạy bên trong Claude Code (mã nguồn mở)

Hypomnema là một wiki cá nhân LLM-native OSS hoạt động trong Claude Code chỉ với một lệnh slash.
Nó tồn tại trong thư mục ~/hypomnema/ dưới dạng Markdown thuần + git, không cần dịch vụ bên ngoài / khóa API / vector DB.
Nguồn gốc người dùng đưa vào được giữ nguyên trong sources/, còn kết quả Claude tổng hợp sẽ được tích lũy trong pages/.
Khi gặp lại cùng một chủ đề, nó sẽ cập nhật trang hiện có thay vì tạo trang mới.

Lý do tạo ra nó là bốn vấn đề tích tụ khi làm việc với AI mỗi ngày.
(1) Chi phí phải giải thích lại ngữ cảnh của ngày hôm qua ở mỗi phiên mới
(2) Kết quả thì tăng rất nhanh nhưng vì sao lại thiết kế như vậy thì không được ghi lại ở đâu, khiến nợ kỹ thuật làm việc debug sau một tháng còn tốn kém hơn
(3) Dù đã thử cả Notion, Obsidian, Confluence, các wiki thủ công vẫn sụp đổ trước bốn cái bẫy: "không có tự động hóa / không có tổng hợp / trở thành di sản / không ai xem"
(4) Một Gist ngắn của Karpathy — "RAG đọc lại từ đầu mỗi lần, còn wiki thì lưu giữ vĩnh viễn tri thức đã được tổng hợp một lần. Nút thắt cổ chai luôn là bookkeeping, và LLM đưa chi phí đó về 0" — đã đưa ra câu trả lời.

Vì vậy, dự án bắt đầu từ hai thư mục Markdown, rồi mỗi khi xuất hiện một điểm gây khó chịu trong công việc hằng ngày thì lại gắn thêm một lifecycle hook.

Tóm tắt cốt lõi

• Khái niệm: Wiki thay cho RAG (Retrieval-Augmented Generation, sinh có tăng cường truy xuất). LLM bảo tồn trang đã tổng hợp một lần, rồi lần sau tiếp tục chồng thêm lên đó. Markdown thuần + git, không có dịch vụ bên ngoài / khóa API / vector DB.
• Cài đặt: npm install -g hypomnema → /hypo:init trong Claude Code.
• Nguồn sự thật duy nhất + phản ánh một chiều: Việc hiệu chỉnh hành vi chỉ được ghi ở một nơi là pages/feedback/<slug>.md. Lệnh hypomnema feedback-sync sẽ tự động tính lại và phản ánh vào MEMORY.md (giới hạn 200 dòng) cùng <learned_behaviors> (giới hạn 10 mục, kiểm tra nghiêm ngặt 5 trường).
• Các trường bắt buộc mới của SCHEMA: Trang type: feedback bắt buộc có 9 trường. upgrade --apply tự động tạo checklist backfill. Bản nháp tự động (stub) bị cố ý từ chối — vì nếu cắm sẵn giá trị mặc định sai, hành vi sai sẽ âm thầm lan sang hai bề mặt phái sinh (MEMORY và CLAUDE.md).
• Đồng bộ kèm file mở rộng: Giữ các thư mục extensions/{agents,commands,hooks,skills} ngay trong wiki và tự động mirror sang ~/.claude/. Nếu dùng cờ --codex, chỉ tập con hooks + commands (bao gồm các hook cốt lõi) mới được mirror sang ~/.codex/.
• Tăng cường tự động hóa: Nếu thư mục làm việc hiện tại (cwd) không có dự án wiki thì tự động gợi ý tạo, khi một phiên có ý nghĩa kết thúc thì tự động gợi ý bước chốt nhẹ (minimal crystallize), sau WebFetch / WebSearch thì hiển thị gợi ý /hypo:ingest, thông báo cập nhật qua 2 kênh (npm / plugin), cảnh báo lint W8 để phát hiện design-history.md cũ, chặn việc hiệu chỉnh bị rò sang dự án khác (bắt buộc khớp chính xác scope: project:*), dọn dẹp chú thích mã theo giai đoạn 1 (loại bỏ các tham chiếu gắn với thời điểm dễ mất nghĩa theo thời gian, giữ lại các mốc neo thiết kế).

Khác biệt với các OSS LLM Wiki hiện có

Trong thời gian ngắn đã xuất hiện hơn 10 dự án bắt nguồn từ Karpathy Gist.
Nếu tổng hợp theo từng mảng sau khi trực tiếp xem xét, có thể thấy khác biệt như sau.

• Các mảng Hypomnema tập trung xử lý chính: tự động hóa vòng đời phiên (gom vận hành wiki vào SessionStart / PreCompact / Stop... bằng 14 hook), biến việc hiệu chỉnh hành vi AI thành nguồn sự thật duy nhất + phản ánh tự động một chiều, mirror tự động ~/.claude/{commands,agents,skills,hooks}.
• nvk/llm-wiki: Mạnh ở chế độ kiểm chứng chạy song song các agent ủng hộ/phản đối luận đề bằng --mode thesis.
• SamurAIGPT/llm-wiki-agent: Mạnh về ingest đa định dạng như PDF / Word / PPT / Excel.
• nashsu/llm_wiki: GUI desktop Electron (6.6k stars) trưởng thành nhất.

Hypomnema cố ý không xây dựng thesis mode, ingest đa định dạng hay GUI riêng — các dự án trên làm tốt hơn ở những mảng đó, và nếu cần thì có thể dùng cùng các công cụ hiện có như Obsidian.
Tóm lại, điểm mạnh nhất của Hypomnema là kéo wiki vào ngay trong workflow hằng ngày mà người dùng Claude Code thực sự dùng.

Thành phần

8 slash command (/hypo:ingest, /hypo:query, /hypo:crystallize, /hypo:resume, /hypo:feedback, /hypo:verify, /hypo:lint, /hypo:graph) + 5 CLI subcommand (init, upgrade [--apply] [--codex], doctor [extensions], uninstall, feedback-sync) + 14 lifecycle hook + tương thích Claude Agent Skills.
Chi tiết hoạt động của từng lệnh và hook đã được tổng hợp trong README và bài walkthrough tiếng Anh trên dev.to.

Những gì cố ý loại bỏ

Không có vector DB, khóa API, GUI, mode matrix, stub SCHEMA tự động — tất cả đều bị loại bỏ có chủ đích vì либо "giá trị mặc định sai sẽ âm thầm chảy thành hành vi sai" hoặc "đã có công cụ khác làm tốt".

Yêu cầu + liên kết

• Node.js ≥ 18 / Claude Code CLI
• GitHub: https://github.com/sk-lim19f/Hypomnema · npm: https://www.npmjs.com/package/hypomnema · License: MIT
• Bài hồi tưởng: https://velog.io/@dlatkdrb980219/…

Hướng dẫn đóng góp

Hoan nghênh feedback, issue và PR.