zosmaai/pi-llm-wiki

📚 pi‑llm‑wiki – 자기 유지형, Obsidian 호환 LLM 기반 위키

What it is

• 오픈 소스 확장 기능(npm 패키지 @zosmaai/pi-llm-wiki)으로, 일반 Markdown 파일로 구성된 지속 가능한 상호 연결 지식 기반을 구축할 수 있습니다. pi 코딩 에이전트 생태계(및 호환되는 oh‑my‑pi 호스트)를 위해 설계되었지만, 일반 MCP(Model‑Client‑Protocol) 서버도 포함하여 Claude‑Code, Cursor, Windsurf, Zed 등 모든 클라이언트에서 사용할 수 있습니다.
• Andrej Karpathy의 LLM Wiki 패턴을 따릅니다. 원시 소스를 캡처하고, LLM이 이를 수집하여 생성된 요약이 영구적인 위키 페이지가 되어 모델이 나중에 쿼리할 수 있습니다.

Why it matters

• 대부분의 RAG 설정은 문서를 일회성 조회로 처리합니다. pi‑llm‑wiki는 소스를 불변 패킷으로 변환하고, 구조화된 소스 페이지를 생성한 다음, 표준 개념/엔터티/통합/분석 페이지를 만드는 중간 계층을 추가합니다. 따라서 위키는 복리로 성장하며, 각각의 새 소스와 답변된 질문은 점점 커지는 검색 가능한 지식 그래프의 일부가 됩니다.
• 모든 페이지는 안정적인 프런트 매터와 인용 ID를 가진 이식 가능한 Obsidian 친화적 Markdown 스키마인 Open Knowledge Format (OKF) v0.2로 저장됩니다. 출처를 잃지 않고 보관소를 이동하거나, 버전 관리하거나, 내보낼 수 있습니다.

Key concepts & architecture

계층	위치	역할
개인	~/.llm-wiki/	항상 활성화되어 프로젝트 간 개인 지식을 유지합니다.
프로젝트	<project>/.llm-wiki/	선택적 프로젝트별 위키로, 개인 계층에서도 읽을 수 있습니다.
회사 (향후)	Git 추적 저장소	공유 팀 위키. 페이지는 wiki_publish로 승격됩니다.

확장 기능은 현재 디렉터리에서 위쪽으로 .llm-wiki/ 폴더를 찾아 활성 보관소를 결정하며, 찾지 못하면 개인 보관소로 폴백합니다.

Main capabilities

• 캡처 (wiki_capture_source) – URL, PDF, Markdown, JSON, XML 또는 붙여넣은 텍스트를 불변 소스 패킷(raw/sources/SRC‑…)으로 변환합니다.
• 수집 (wiki_ingest) – 캡처된 패킷을 소스 요약, 개념, 엔터티, 통합, 분석의 네 계층 위키 페이지로 일괄 처리합니다.
• 리콜 / 쿼리 (wiki_recall, /wiki-query) – 개인 및 프로젝트 보관소를 모두 검색하고, 적절한 인용이 포함된 모델 생성 답변을 얻고, 선택적으로 답변을 분석 페이지로 저장합니다.
• 검색 및 인덱스 (wiki_search, wiki_reindex) – 모델 없는 어휘 QMD 인덱스에 더해 선택적 시맨틱 임베딩.
• 린트 및 가드레일 (wiki_lint) – 고아 페이지, 끊어진 링크, 중복 별칭, 커버리지 갭 등에 대한 결정적 건강 검사.
• 대시보드 (wiki_status, /wiki-dashboard) – 페이지 수, 최신성, 최근 활동, 수집 큐를 빠르게 확인.
• 자동 부트스트랩 – 폴더에서 확장 기능을 처음 실행하면 새 위키 생성(/wiki-init)을 제안합니다.
• 에이전트 작업 메모리(옵트인) – 완료된 작업의 도구 호출 궤적을 캡처하고(wiki_capture_trajectory), 나중에 재사용 가능한 스킬 페이지로 증류합니다(wiki_distill_skills, /wiki-skills).
• MCP 서버 – 모든 도구를 노출하는 독립 실행형 stdio 서버(dist/mcp/index.js)로, pi 호스트 없이도 모든 MCP 호환 클라이언트가 위키를 사용할 수 있습니다.

Installation & first use

# pi 호스트 사용 시
pi install npm:@zosmaai/pi-llm-wiki
# oh‑my‑pi 사용 시
omp install @zosmaai/pi-llm-wiki
# 다른 MCP 클라이언트의 일반 npm 개발 종속성으로
npm install --save-dev @zosmaai/pi-llm-wiki

그런 다음 터미널(또는 pi/omp의 슬래시 명령)에서:

/wiki-init "AI research"
/wiki-capture_source https://example.com/article
/wiki_ingest   # 또는 /wiki-ingest
/wiki-query "What are the trade‑offs between long‑context models and RAG?"

README의 데모 GIF는 pi 내부의 UI 흐름을 보여줍니다.

Configuration

• WIKI_ROOT (보관소 위치 재정의) 및 WIKI_MARKITDOWN_TIMEOUT_MS (PDF→Markdown 추출 제한 시간)과 같은 환경 변수가 존중됩니다.
• 설정은 호스트 구성 파일(.pi/settings.json, .omp/settings.json 등)에서 읽히며 /wiki-settings 슬래시 명령으로 편집할 수 있습니다.

Project health

• CI 배지, npm 버전, 다운로드 통계, 85% 테스트 커버리지, CodeQL, Biome 린팅이 모두 README에 표시되어 적극적으로 유지 관리되는 TypeScript 코드베이스임을 나타냅니다.
• 문서는 https://zosmaai.github.io/pi-llm-wiki/에서 호스팅됩니다.

Who might use it

• LLM 지원 작업과 동기화되는 개인 지식 기반을 원하는 연구자나 엔지니어.
• 동일한 OKF 형식으로 구축된 회사 전체 위키를 공유할 계획인 팀.
• pi 또는 oh‑my‑pi 에이전트, 또는 MCP 호환 IDE를 사용하면서 독점 RAG 저장소의 대안으로 파일 기반, 버전 관리를 원하는 모든 사람.

---

TL;DR: pi-llm-wiki는 원시 문서를 이식 가능하고 Obsidian 호환 Markdown 위키로 변환하는 TypeScript npm 패키지로, LLM이 자동으로 유지 관리합니다. pi/oh‑my‑pi 에이전트 및 모든 MCP 클라이언트와 함께 작동하며, 캡처, 수집, 검색 가능한 리콜, 상태 확인, 선택적 에이전트 궤적 메모리를 제공합니다—모두 오픈되고 버전 관리되는 형식으로.