LLM Wiki

Hệ thống knowledge base cá nhân hoàn toàn tự động, vận hành bởi LLM. Dựa trên pattern LLM Wiki của Andrej Karpathy.

LLM tự tìm nguồn, tự tổng hợp thành wiki có cấu trúc, tự duy trì cross-references, phát hiện mâu thuẫn, và giữ mọi thứ cập nhật — bạn chỉ cần đọc và hỏi.

Hỗ trợ: Claude Code | Antigravity / Codex | GitHub Copilot

Mỗi tool tự đọc file config riêng: CLAUDE.md | AGENTS.md | .github/copilot-instructions.md — cùng nội dung, không conflict.

Khác gì so với RAG?

	RAG truyền thống	LLM Wiki
Kiến thức	Tìm lại từ đầu mỗi lần hỏi	Biên dịch 1 lần, duy trì liên tục
Cross-references	Không có	Tự động tạo và duy trì
Mâu thuẫn	Không phát hiện	Đánh dấu ngay khi ingest
Tích lũy	Không	Compound theo thời gian
Hạ tầng	Vector DB + embeddings	Chỉ cần folders + markdown

Bắt đầu nhanh

1. Clone & Cài đặt

git clone https://github.com/mduongvandinh/llm-wiki.git
cd llm-wiki

# Copy file cấu hình mẫu
cp config.example.yaml config.yaml

# Cài skill vào Claude Code
cp -r skills/llm-wiki ~/.claude/skills/llm-wiki

2. Cấu hình chủ đề quan tâm

Sửa config.yaml — thêm topics, keywords, và nguồn theo dõi:

topics:
  - name: "Chủ đề của bạn"
    keywords: ["từ khóa 1", "từ khóa 2"]
    priority: high

3. Chạy

Tùy tool bạn dùng:

Claude Code (slash command):

/llm-wiki run          # Chạy full cycle
/llm-wiki query "..."  # Hỏi đáp
/llm-wiki status       # Xem trạng thái

Antigravity (slash command hoặc chat):

@llm-wiki run
# hoặc chat: "chạy llm-wiki full cycle"

GitHub Copilot (chat tự nhiên — tự đọc .github/copilot-instructions.md):

"Đọc CLAUDE.md rồi chạy discover, ingest, lint cho wiki này"
"Tìm nguồn mới về AI agents rồi tổng hợp vào wiki"
"Hỏi dựa trên wiki: so sánh RAG vs LLM Wiki"

Codex CLI:

codex "Đọc AGENTS.md và chạy full cycle: discover → ingest → lint"

Cursor (chat trong IDE):

"Follow AGENTS.md. Chạy discover tìm nguồn mới, ingest vào wiki, rồi lint kiểm tra"

Tóm tắt cách gọi theo tool

Tool	Cách gọi	File config	Cài skill
Claude Code	/llm-wiki run	CLAUDE.md	cp -r skills/llm-wiki ~/.claude/skills/
Antigravity	@llm-wiki run	AGENTS.md	cp -r skills/llm-wiki ~/.antigravity/skills/
GitHub Copilot	Chat tự nhiên	.github/copilot-instructions.md	Không cần — tự đọc khi mở project
Codex CLI	codex "..."	AGENTS.md	Không cần — đọc AGENTS.md ở root
Cursor	Chat trong IDE	AGENTS.md hoặc .cursorrules	Không cần — đọc AGENTS.md ở root

Lưu ý:

• Chỉ Claude Code và Antigravity có slash command (/llm-wiki). Các tool khác bạn chat bằng ngôn ngữ tự nhiên.
• /loop chỉ có ở Claude Code. Các tool khác muốn chạy tự động thì dùng Task Scheduler (Windows) hoặc crontab (macOS/Linux).

Chạy tự động theo tool

Tool	Cách chạy tự động
Claude Code	/loop 1h /llm-wiki run (trong session)
Antigravity	Task Scheduler / crontab
Codex CLI	crontab gọi codex "Đọc AGENTS.md và chạy discover → ingest → lint"
GitHub Copilot	Không hỗ trợ — chỉ chat trong IDE
Cursor	Không hỗ trợ — chỉ chat trong IDE

Xem thêm phần Chạy tự động bên dưới để cấu hình Task Scheduler / crontab.

4. Xem wiki

• Obsidian: File → Open vault → chọn folder llm-wiki → Graph View
• Browser: mở wiki-viewer.html để xem dashboard + graph (hỗ trợ mobile)

---

Danh sách lệnh

Lệnh	Mô tả
/llm-wiki init "Topic"	Thêm chủ đề mới
/llm-wiki ingest	Xử lý nguồn mới trong raw/
/llm-wiki query "..."	Hỏi đáp dựa trên wiki, tự lưu kết quả
/llm-wiki lint	Kiểm tra sức khỏe: mâu thuẫn, orphans, gaps
/llm-wiki discover	Tự tìm nguồn mới từ internet
/llm-wiki run	Full cycle: discover → ingest → lint
/llm-wiki status	Xem trạng thái tổng quan
/llm-wiki digest	Bản tin hàng ngày: nguồn mới, insights, pain points
/llm-wiki pain-rank	Xếp hạng pain points theo tiềm năng kinh doanh

---

Chạy tự động

Cách 1: /loop trong Claude Code (khuyến nghị)

/loop 1h /llm-wiki run    # Mỗi 1 giờ
/loop 30m /llm-wiki run   # Mỗi 30 phút
/loop 2h /llm-wiki run    # Mỗi 2 giờ

Chạy trong session hiện tại. Không tốn thêm chi phí. Dừng khi đóng session.

Cách 2: Lập lịch hệ thống (chạy nền, không cần mở Claude Code)

Windows (PowerShell, chạy với quyền Admin):

powershell -ExecutionPolicy Bypass -File "scripts/setup-scheduler.ps1"

macOS/Linux (crontab):

# Thêm vào crontab -e:
0 */2 * * * cd /path/to/llm-wiki && claude --print "/llm-wiki run" >> outputs/auto-run.log 2>&1

So sánh

	/loop (trong session)	Lập lịch hệ thống
Khi nào chạy	Khi mở Claude Code/VS Code	Bất cứ lúc nào máy bật
Tần suất	Linh hoạt (10 phút đến 2 giờ)	Cố định (VD: mỗi 2 giờ)
Chi phí token	Thấp (cùng session)	Cao hơn (mỗi lần = session mới)
Cài đặt	Gõ lệnh là xong	Chạy script 1 lần (quyền admin)

---

Thêm nguồn

Thủ công

Tạo file markdown rồi bỏ vào raw/articles/, raw/reddit/, hoặc raw/notes/:

---
title: "Tiêu đề bài viết"
url: "https://example.com/article"
author: "Tên tác giả"
discovered: 2026-04-07
topic: "Tên chủ đề"
---

Nội dung bài viết ở đây...

Sau đó chạy /llm-wiki ingest.

Qua Obsidian Web Clipper

1. Cài extension Obsidian Web Clipper
2. Thấy bài hay → click icon clipper → lưu vào raw/articles/
3. Chạy /llm-wiki ingest

---

Cấu trúc thư mục

llm-wiki/
├── CLAUDE.md              ← Schema cho Claude Code
├── AGENTS.md              ← Schema cho Antigravity / Codex
├── .github/
│   └── copilot-instructions.md  ← Schema cho GitHub Copilot
├── config.yaml            ← Cấu hình chủ đề, nguồn, lịch chạy
├── config.example.yaml    ← File mẫu cho người dùng mới
├── wiki-viewer.html       ← Trình xem wiki (mobile-first, dark theme, graph)
├── raw/                   ← Nguồn thô (LLM KHÔNG ĐƯỢC SỬA)
│   ├── articles/          ← Bài viết, papers
│   ├── reddit/            ← Pain points, use cases từ Reddit
│   ├── twitter/           ← Tweets (follow-builders + Web Clipper)
│   ├── notes/             ← Ghi chú cá nhân
│   └── media/             ← Ảnh chụp, sơ đồ
├── wiki/                  ← Wiki do LLM viết & duy trì
│   ├── INDEX.md           ← Danh mục tất cả trang wiki
│   ├── LOG.md             ← Nhật ký hoạt động
│   ├── entities/          ← Người, tổ chức, công cụ, dự án
│   ├── concepts/          ← Khái niệm, pattern, phương pháp
│   ├── sources/           ← Tóm tắt từng nguồn thô
│   └── syntheses/         ← Phân tích tổng hợp, so sánh
├── outputs/               ← Kết quả hỏi đáp, báo cáo, xếp hạng
├── .discoveries/          ← Metadata cho auto-discovery
├── scripts/               ← Scripts tự động
│   ├── run-wiki.sh        ← Cho lập lịch hệ thống
│   └── setup-scheduler.ps1
├── skills/                ← Claude Code skill (copy vào ~/.claude/skills/)
│   └── llm-wiki/
│       └── SKILL.md
└── docs/plans/            ← Tài liệu thiết kế

---

Kiến trúc

┌──────────────────────────────────────────────────────┐
│                  BẠN (đọc & hỏi)                      │
├──────────────────────────────────────────────────────┤
│  wiki/          │  outputs/        │  wiki-viewer     │
│  (Obsidian)     │  (bản tin, rank) │  (.html)         │
├──────────────────────────────────────────────────────┤
│                  LLM (viết & duy trì)                 │
├──────────┬───────────┬──────────┬────────────────────┤
│ discover │  ingest   │  query   │  lint              │
│ (tìm)    │ (xử lý)   │ (đáp)    │ (kiểm tra)        │
├──────────┴───────────┴──────────┴────────────────────┤
│  raw/           │  config.yaml     │  CLAUDE.md       │
│  (nguồn thô)    │  (cấu hình)      │  (quy tắc)       │
└──────────────────────────────────────────────────────┘

Luồng chính: discover → raw/ → ingest → wiki/ → query → outputs/

Vòng lặp tự cải thiện: lint phát hiện gaps → discover tìm nguồn → ingest lấp đầy → wiki ngày càng giàu

---

Câu hỏi thường gặp

Xem FAQ.md — bao gồm: wiki phình to truy vấn thế nào, versioning schema, dùng cho tài liệu nội bộ (Confluence), chi phí token, dùng cho team, dùng model khác, hallucination.

---

Tác giả & Nguồn cảm hứng

• Pattern gốc: Andrej Karpathy — LLM Wiki
• Hướng dẫn thực hành: Nick Spisak — How to Build Your Second Brain
• Engine: Claude Code (Anthropic)
• Xem wiki: Obsidian
• Bản tin Twitter: follow-builders

Giấy phép

MIT