개요
llm-wiki와 OpenWiki는 모두 AI 에이전트를 위한 지식 베이스를 지향하지만, 접근 방식과 운영 모델에서 핵심 차이가 있다.
| 구분 | llm-wiki | OpenWiki |
|---|---|---|
| 출처 | Karpathy식 LLM Wiki 패턴 | LangChain 공식 공개 CLI |
| 데이터 저장소 | 로컬 파일 시스템 (마크다운) | 로컬 파일 시스템 (마크다운) |
| 주도 주체 | 에이전트 + 사람 (공동 편집) | 에이전트 (자동 생성·유지) |
| 설정 파일 | AGENTS.md / CLAUDE.md | openwiki.yaml 설정 |
| 트리거 | 사람이 수동으로 페이지를 작성·편집 | CLI 명령으로 코드베이스 스캔 후 문서 자동 생성 |
| 링크 구조 | [[slug]] wikilink (basename 기준) | 명시적 참조 ([[ref:...]] 등) |
| 타입 디렉토리 | entity / concept / comparison / summary / query | wiki/overview / wiki/codebase 등 |
| 웹 호스팅 | 선택 (별도 웹 서버) | 기본 로컬 파일 |
| 핵심 철학 | 사람이 구조를 설계하고 에이전트가 채움 | 에이전트가 코드를 읽고 스스로 문서를 갱신 |
llm-wiki
출처: Karpathy의 LLM Wiki 패턴에서 유래. Hermes Agent의 표준 구조로 통합.
- 파일 하나 = 문서 하나, 앞뒤 링크로 지식 그래프 구성
type:frontmatter로 문서 타입 자동 분류scripts/build_index.py로 인덱스 자동 생성raw/계층(불변 원본)과entities//concepts/등 가공 계층 분리- 사람과 에이전트가 공동으로 작성, 에이전트 세션 간 영속 메모리 역할
OpenWiki
출처: LangChain의 OpenWiki CLI — AI Sparkup 위키 문서.
- 코드베이스를 읽고 AGENTS.md·CLAUDE.md에서 참조하는 형태의 문서를 자동 생성·유지
npx -y openwiki generate같은 명령으로 에이전트용 코드 문서화- 코드 변경 시 문서 자동 동기화를 목표
- LangChain 생태계와의 긴밀한 통합 (LangGraph, LangSmith 연동 가능)
핵심 차이 요약
| 관점 | llm-wiki | OpenWiki |
|---|---|---|
| 문서 출처 | 사람·에이전트 혼합 작성 | 에이전트가 코드로 부터 자동 생성 |
| 목표 | 에이전트의 2차 뇌 (넓은 지식 그래프) | 코드 문서 자동화 (특정 코드베이스 대상) |
| 범위 | 일반 지식, 프로젝트, 검색 결과, 정리 노트 | 코드베이스 문서, API 레퍼런스 |
| 편집 주체 | 사람도 주체적으로 작성 | 주로 에이전트가 갱신 |
| 확장성 | 파일 시스템만 되면 어디든 운영 가능 | LangChain CLI 의존 |
언제 무엇을 쓰나
- llm-wiki: 프로젝트 전반의 지식, 검색 결과 정리, 에이전트 간 협업 메모리, 일반 문서화
- OpenWiki: 코드베이스 문서 자동화, AGENTS.md/CLAUDE.md 생성, 코드리뷰 문서화
출처
- https://aisparkup.com/wiki/openwiki (AI Sparkup 위키 — 2026-07-02)