원문 GeekNews — OpenWiki (xguru, 2026-07-20) · 저장소 langchain-ai/openwiki (MIT, TypeScript, 2026-06-22 생성, 수집 시점 Stars 약 1.7만)

한 줄 요약

OpenWiki는 사람이 아니라 코딩 에이전트가 읽을 문서를 LLM이 쓰고 계속 고쳐 나가는 CLI다. 저장소 하나를 문서화하는 Code 모드와, Notion·Gmail·X 같은 개인 소스를 모아 ~/.openwiki/wiki에 “개인 브레인”을 만드는 Personal 모드가 있다. 결과물은 Google의 Open Knowledge Format(OKF) 번들이라 다른 도구로 옮길 수 있다.

두 모드

모드문서화 대상저장 위치시작 명령
Code (기본)현재 저장소저장소의 openwiki/openwiki --init
Personal연결한 개인 소스~/.openwiki/wikiopenwiki personal --init

설치는 npm install -g openwiki. 코드 변경 뒤에는 openwiki --update로 마지막 성공 실행 이후 바뀐 부분만 반영한다. Personal 모드는 커넥터(로컬 Git 저장소, Notion, Gmail, X, 웹 검색, Hacker News)로 자료를 가져오며, 같은 커넥터를 여러 인스턴스로 둘 수 있다. Personal 모드가 나온 배경은 2026-07-11-openwiki-brains-general-purpose-memory-for-agents에 있다.

에이전트가 위키를 쓰게 만드는 방식

  • AGENTS.md·CLAUDE.md 관리: Code 모드는 실행할 때마다 저장소 루트의 AGENTS.md를 유지한다. 기존 파일이 있으면 <!-- OPENWIKI:START -->…<!-- OPENWIKI:END --> 블록만 고치고 나머지는 건드리지 않는다. 그래서 사람이 쓴 지침과 자동 생성 안내가 한 파일에 공존한다.
  • CI 자동 갱신: GitHub Actions·GitLab CI 예시 워크플로를 주며, 문서가 바뀌면 문서 전용 PR(merge request)을 연다. 하루 1회 PR 흐름은 2026-07-06-openwiki-coding-agent-codebase-documentation-cli에서도 소개됐다.
  • OKF 출력: 두 모드 모두 OKF 번들을 낸다. 개념 문서마다 type 필드가 있는 YAML front matter를 두고, 문서 사이 관계는 표준 Markdown 링크로 표현한다. OKF 자체는 2026-06-18-open-knowledge-format-data-sharing 참고.

모델과 텔레메트리

GeekNews 소개 시점에는 OpenAI, OpenRouter, Gemini(AI Studio·Vertex AI), Nebius, Fireworks, Baseten, NVIDIA NIM, OpenAI 호환, AWS Bedrock, Anthropic을 지원했다. 온보딩 기본 모델은 OpenAI gpt-5.6-terra이고, ChatGPT 로그인·IAM 자격 증명·Google ADC처럼 프로바이더별 인증을 쓴다.

텔레메트리는 기본으로 켜져 있다. README에 따르면 보내는 것은 무작위 설치 ID에 묶인 명령(init/update), 결과(성공·실패·no-op와 거친 오류 분류), 설정 시점의 모드·프로바이더·커넥터 이름뿐이다. 파일 내용, 저장소 이름, 자격 증명, 프롬프트, 모델 출력, 경로, IP는 보내지 않는다. OPENWIKI_TELEMETRY_DISABLED=1 또는 DO_NOT_TRACK=1로 끄고, --telemetry-file=<경로>로 실제 전송 내용을 미리 볼 수 있다.

GeekNews 댓글에서는 이 기본값이 쟁점이었다. 한 사용자는 “끌 수는 있어도 기본값대로 쓰는 사람이 대부분”이라며 아쉬워했다. 이후 그는 ‘명령·결과’를 프롬프트·출력으로 잘못 읽었다고 정정하고 “그럼 괜찮을지도”라고 물러섰다. 수집 범위가 좁다는 점은 맞지만, 끄려면 사용자가 직접 설정해야 한다는 지적은 그대로 남는다.

7월 이후 달라진 점 (2026-10 README 기준)

GeekNews 글 이후 석 달 사이 저장소가 꽤 바뀌었다. 위 소개를 읽을 때 다음을 함께 봐야 한다.

  • 코딩 에이전트 통합이 기본 경로가 됐다. openwiki integrations install <claude|codex|cursor|opencode|copilot|…>로 스킬과 MCP를 깔면, 에이전트 안에서 “이 저장소의 OpenWiki를 초기화해 줘”라고 말해 위키를 만든다. 이때는 호스트 에이전트의 모델 세션을 쓴다. 위키 검색용 openwiki_search·openwiki_read는 모델을 부르지 않는 로컬 읽기 전용 도구다.
  • Grounded Claims: 저장소 페이지의 사실마다 repo://src/server.ts#L40-L82 같은 버전 고정 근거를 openwiki/.claims/에 따로 저장한다. 근거 코드가 바뀌면 어떤 사실을 확인·수정·폐기할지 골라내므로, 업데이트가 바뀐 부분에만 모델을 쓴다. 변경이 없으면 모델 호출 없이 끝난다.
  • OKF v0.2: 출력이 v0.1에서 v0.2로 올라갔다. generated·verified 스탬프와 sources를 채우며, verified는 근거 재확인을 통과한 페이지에만 붙는다. 이 볼트의 validator가 OKF v0.2 필드를 받아들이는 것도 같은 스펙이다.
  • 그 밖에: 여러 저장소 위키를 묶어 함께 검색하는 openwiki link 워크스페이스, 그래프 시각화 openwiki visualize(정적 내보내기 가능), 페이지 병렬 작성(OPENWIKI_PAGE_CONCURRENCY 1~8), 프로바이더 13종(Ollama·LM Studio 같은 로컬 엔드포인트 포함), 커넥터 9종(Custom MCP·Slack 추가), Bitbucket 예시 워크플로.

이 볼트와 비교하면

OpenWiki와 이 볼트는 둘 다 “LLM이 유지하는 Markdown 위키” 계열이다. 차이는 자동화 수준과 신뢰 장치다. 이 볼트는 사람이 소스를 고르고 에이전트가 요약·링크를 쓰며, 사실 검증은 원문 대조로 한다. OpenWiki는 코드에서 사실을 뽑고, 근거가 바뀌면 Claims로 그 사실을 다시 확인한다. 자세한 비교는 2026-07-04-llm-wiki-vs-openwiki-comparison, 위키를 에이전트 메모리로 쓰는 논의는 2026-07-11-llm-wikis-and-how-to-give-your-agents-memory에 있다. 비슷한 저장소 문서화 도구로는 2026-08-08-github-sopaco-deepwiki-rs가 있다.

관련 노트