개요
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 기준)
openwiki --init또는 코딩 에이전트에 “이 저장소의 OpenWiki를 초기화해 줘”라고 요청 → 에이전트가 저장소를 조사해openwiki/에 링크된 위키를 쓴다. 범위 제외는.openwikiignore, 작성 지침은openwiki/INSTRUCTIONS.md.- 저장소 페이지의 사실은 버전 고정 근거와 함께 Grounded Claims로
openwiki/.claims/에 저장된다. openwiki --update는 변경된 코드와 근거가 바뀐 Claims만 골라 다시 쓴다. 변경이 없으면 모델을 부르지 않는다.- 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에서 검토했다(결론: 직접 적용 불가)
출처
- AI Sparkup 위키: https://aisparkup.com/wiki/openwiki (2026-07-02)
- GeekNews: https://news.hada.io/topic?id=31594 (2026-07-20) — 2026-07-20-news-hada-31594-openwiki