개요

llm-wiki와 OpenWiki는 모두 AI 에이전트를 위한 지식 베이스를 지향하지만, 접근 방식과 운영 모델에서 핵심 차이가 있다.

구분llm-wikiOpenWiki
출처Karpathy식 LLM Wiki 패턴LangChain 공식 공개 CLI
데이터 저장소로컬 파일 시스템 (마크다운)로컬 파일 시스템 (마크다운)
주도 주체에이전트 + 사람 (공동 편집)에이전트 (자동 생성·유지)
설정 파일AGENTS.md / CLAUDE.mdopenwiki/INSTRUCTIONS.md(작성 지침) · .openwikiignore(읽기 제외) · ~/.openwiki/(키·상태)
트리거사람이 수동으로 페이지를 작성·편집CLI 명령으로 코드베이스 스캔 후 문서 자동 생성
링크 구조[[slug]] wikilink (basename 기준)표준 마크다운 링크 (OKF v0.2)
타입 디렉토리entity / concept / comparison / summary / query고정 타입 폴더 없음 — openwiki/(code) 또는 ~/.openwiki/wiki(personal) 아래 OKF concept 페이지
웹 호스팅선택 (별도 웹 서버)기본 로컬 파일, openwiki visualize --export로 정적 뷰어 생성
핵심 철학사람이 구조를 설계하고 에이전트가 채움에이전트가 코드를 읽고 스스로 문서를 갱신

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에서 참조하는 형태의 문서를 자동 생성·유지
  • npm install -g openwiki 후 openwiki --init(생성) · openwiki --update(변경분 반영)로 에이전트용 코드 문서화. openwiki personal --init은 ~/.openwiki/wiki에 개인 위키를 만든다
  • 코드 변경 시 문서 자동 동기화를 목표
  • LangChain 생태계와의 긴밀한 통합 (LangGraph, LangSmith 연동 가능)

핵심 차이 요약

관점llm-wikiOpenWiki
문서 출처사람·에이전트 혼합 작성에이전트가 코드로 부터 자동 생성
목표에이전트의 2차 뇌 (넓은 지식 그래프)코드 문서 자동화 (특정 코드베이스 대상)
범위일반 지식, 프로젝트, 검색 결과, 정리 노트코드베이스 문서, API 레퍼런스
편집 주체사람도 주체적으로 작성주로 에이전트가 갱신
확장성파일 시스템만 되면 어디든 운영 가능LangChain CLI 의존

언제 무엇을 쓰나

  • llm-wiki: 프로젝트 전반의 지식, 검색 결과 정리, 에이전트 간 협업 메모리, 일반 문서화
  • OpenWiki: 코드베이스 문서 자동화, AGENTS.md/CLAUDE.md 생성, 코드리뷰 문서화

출처