개요

OpenWiki는 LangChain이 공개한 CLI 도구로, 코드베이스를 읽어 AI 에이전트용 문서를 자동으로 생성·유지한다. 생성된 문서는 AGENTS.md·CLAUDE.md에서 참조하는 형태로 출력되어, 에이전트 세션에서 프로젝트 맥락을 빠르게 이해하도록 돕는다.

2026-07-11에는 Personal Brains 모드가 추가됐다 — Git 레포에 종속된 기존 “코드 브레인”과 달리, Notion·Gmail·X/Twitter·웹 검색·Hacker News 같은 개인 서비스를 커넥터로 연결해 프로액티브하게 순회하며 범용 에이전트 메모리를 만든다. 결과물은 레포 루트가 아니라 컴퓨터 루트(~/.openwiki)에 저장되어 그 머신의 모든 에이전트 세션이 공유한다. 자세한 내용은 2026-07-11-openwiki-brains-general-purpose-memory-for-agents 참고.

주요 특징

항목내용
공식 출처LangChain (langchain-ai/openwiki, MIT, TypeScript, Deep Agents 기반)
설치npm install -g openwiki
핵심 명령openwiki --init(생성) · openwiki --update(변경분 반영) · openwiki personal --init(개인 브레인)
출력 포맷Google OKF 번들(2026-07 v0.1 → 2026-10 v0.2), 저장소의 openwiki/ 또는 ~/.openwiki/wiki
에이전트 연동저장소 루트 AGENTS.md의 OPENWIKI:START…END 블록 관리, 코딩 에이전트용 스킬·MCP(openwiki_search·openwiki_read)
텔레메트리기본 켜짐(명령·결과·프로바이더·커넥터 이름 수준), OPENWIKI_TELEMETRY_DISABLED=1로 끔

작동 방식 (2026-10 README 기준)

  1. openwiki --init 또는 코딩 에이전트에 “이 저장소의 OpenWiki를 초기화해 줘”라고 요청 → 에이전트가 저장소를 조사해 openwiki/에 링크된 위키를 쓴다. 범위 제외는 .openwikiignore, 작성 지침은 openwiki/INSTRUCTIONS.md.
  2. 저장소 페이지의 사실은 버전 고정 근거와 함께 Grounded Claims로 openwiki/.claims/에 저장된다.
  3. openwiki --update는 변경된 코드와 근거가 바뀐 Claims만 골라 다시 쓴다. 변경이 없으면 모델을 부르지 않는다.
  4. GitHub Actions·GitLab CI·Bitbucket 예시 워크플로로 정기 실행하면 문서 전용 PR이 열린다.

세부 내용과 GeekNews 소개 이후 바뀐 점은 2026-07-20-news-hada-31594-openwiki 참고.

llm-wiki와의 차이

  • llm-wiki는 넓은 지식 그래프(일반 문서·검색·정리)를 지향
  • OpenWiki는 코드베이스 문서 자동화에서 출발해 Personal 모드로 개인 지식까지 넓혔다
  • llm-wiki의 엔티티는 사람이 주체적으로 작성, OpenWiki는 코드·커넥터 자료에서 자동 생성
  • 이 볼트에 직접 적용할 수 있는지는 2026-10-06-openwiki-vault-applicability에서 검토했다(결론: 직접 적용 불가)

출처