nvk/llm-wiki

llm‑wiki – AI 에이전트를 위한 LLM 컴파일 지식 베이스

개요 – llm‑wiki는 대형 언어 모델 에이전트(Claude, OpenAI Codex, OpenCode, Pi 등)가 개인 또는 팀 전체 위키를 구축, 유지 관리 및 쿼리할 수 있게 해주는 오픈 소스 시스템입니다. 위키는 구조화되고 Obsidian 호환 폴더 레이아웃으로 아이디어, 연구, 프로젝트 및 아티팩트를 저장하며, 에이전트는 소스를 자동으로 수집하고, 병렬 연구를 실행하고, 콘텐츠를 감사하고, 검토된 브리프를 전달 가능한 프로젝트로 승격시킬 수 있습니다.

주요 개념

• 세션 – 에이전트가 위키 세션에서 수행한 작업을 기록하는 선택적 에이전트별 메모리입니다. 사용자별로 비활성화할 수 있습니다.
• 어댑터 – 웹, CSV, media‑wiki와 같은 특정 공급자에게 수집 및 쓰기 작업을 라우팅하는 프라이빗 매니페스트 기반 플러그인 시스템이며, 인증 및 부작용을 엄격하게 제어합니다.
• 연구 모드 – 원샷 쿼리, 심층 다중 에이전트 연구, 논문 기반 조사 및 전문가 방법 선택.
• 체크포인트 내보내기 – docs/knowledge/<slug>/ 스냅샷으로, 프로젝트 지식의 결정론적이고 개인 정보를 최소화한 인계를 포함합니다.

지원되는 런타임

런타임	호출 방법	읽기 전용 쿼리 크기	전체 연구 크기
Claude Code (네이티브)	/wiki:… 명령 또는 @wiki 스킬	wiki:query (≈2.8 KB)	@wiki (≈11.7 KB)
OpenAI Codex (마켓플레이스)	플러그인 설치 후 $wiki-query 또는 @wiki	Claude와 동일	Claude와 동일
OpenCode (명령 파일)	opencode.json에 SKILL.md URL 추가	wiki-query/SKILL.md	wiki-manager/SKILL.md
Pi / DS4 (로컬 모델)	./scripts/pi-wiki-query (읽기 전용) 또는 pi --skill …/wiki-manager/SKILL.md (전체)
기타 모든 LLM 에이전트	profiles/query-lite/SKILL.md (읽기 전용) 또는 AGENTS.md (전체) 복사

설치 바로가기

• Claude Code – claude plugin install wiki@llm-wiki
• Codex – codex plugin marketplace add nvk/llm-wiki && codex plugin add wiki@llm-wiki
• OpenCode – 원격 SKILL.md URL을 opencode.json에 추가 (또는 로컬로 curl)
• Pi – pi --skill path/to/llm-wiki/plugins/llm-wiki-opencode/skills/wiki-manager/SKILL.md

일반적인 워크플로우

1. 주제 생성 / 선택 – /wiki:research "nutrition" --new-topic
2. 소스 수집 – /wiki:ingest https://example.com/article 또는 ingest‑collection으로 일괄 가져오기.
3. 연구 실행 – @wiki research "gut‑brain axis" --deep --min-time 2h (읽기, 요약 및 교차 참조를 수행하는 여러 에이전트 생성).
4. 컴파일된 지식 쿼리 – /wiki:query "How does fiber affect mood?" (읽기 전용) 또는 모든 LLM에서 wiki-query.
5. 브리프 승격 – @wiki audit --project coldcard-threat-model이 검토된 브리프를 전달 프로젝트로 이동합니다.
6. 체크포인트 내보내기 – v0.24.0은 인계를 위해 docs/knowledge/ 아래에 재현 가능한 스냅샷을 작성하는 명령을 추가합니다.

아키텍처 하이라이트

• Claude 우선 정보 출처 – 정식 스킬은 claude-plugin/skills/wiki-manager/SKILL.md에 있습니다. 런타임별 래퍼(Codex, OpenCode, Pi)는 동기화 스크립트를 통해 자동으로 생성됩니다.
• 프라이빗 어댑터 프로토콜 (llm‑wiki‑adapter/v1) – 어댑터는 의도, URL 경로 및 읽기/쓰기 권한을 선언합니다. 어떤 공급자 자격 증명도 위키에 포함되지 않으며, 어댑터는 정확한 허용 목록과 멱등성 키를 적용합니다.
• 파일 시스템 허브 – 위키는 사용자 구성 가능 디렉토리(기본적으로 ~/.config/llm-wiki, 대체 ~/wiki)에 있습니다. 이 시스템은 완전히 Obsidian 호환되므로 사용자는 원하는 경우 노트를 수동으로 편집할 수 있습니다.
• 샌드박스 친화성 – 각 런타임에 대해 명시적인 nono 샌드박스 정책이 문서화되어 있어, 에이전트가 필요한 최소한의 읽기/쓰기 액세스 권한을 갖도록 보장합니다.

중요성

• LLM 에이전트에 상태 비저장 프롬프트 대신 영구적이고 검색 가능한 지식 저장소를 제공합니다.
• 재현 가능한 연구 파이프라인을 활성화합니다: 수집 → 병렬 분석 → 감사 → 내보내기.
• 단일 정보 출처를 사용하여 주요 LLM 에이전트 생태계(Claude, Codex, OpenCode, 로컬 모델)에서 작동합니다.

제한 사항 / 주의점

• 이 시스템은 호스트 에이전트가 위키 디렉토리를 읽고 쓸 수 있다고 가정합니다. 샌드박스 환경은 해당 권한을 부여해야 합니다.
• 전체 연구 명령은 쓰기가 가능하며 파일을 수정합니다. 조회만 필요한 경우 읽기 전용 wiki‑query 스킬을 사용하십시오.
• 내보낸 체크포인트는 읽기 전용입니다. 변경 사항을 자동으로 커밋하거나 게시하지 않습니다.

자세히 알아보기

• 프로젝트 사이트: https://llm‑wiki.net/
• GitHub 저장소: https://github.com/nvk/llm-wiki (동기화 검증은 README.md, CHANGELOG.md 및 tests/ 디렉토리 참조)
• 빠른 시작 예제는 README의 Quick Start 섹션에 있습니다.