랭체인, 코드베이스 문서 자동 생성·관리 에이전트 'OpenWiki' 공개

OpenWiki는 랭체인이 공개한 오픈소스 CLI 에이전트다. 코드베이스 문서를 위키 형태로 자동 생성하고 코드 변경 사항에 맞춰 지속적으로 업데이트해, Claude Code 같은 코딩 에이전트가 프로젝트 맥락을 정확하게 파악하도록 돕는다.

AI 에이전트가 코드를 제대로 작성하려면 주요 로직이 어디에 있는지, 파일 간 연결 구조가 어떤지 알아야 한다. 하지만 대다수 개발자가 쓰는 방식은 CLAUDE.md나 AGENTS.md 파일 하나에 모든 설명을 몰아넣는 식이다. 저장소 규모가 커지면 수백 페이지 분량의 문맥이 단일 파일에 쌓여 토큰이 낭비되고, 모델도 핵심을 놓치기 쉽다.

OpenWiki는 안드레이 카파시의 LLM Wiki 개념과 DeepWiki, AutoWiki 등에서 영감을 얻었다. 모든 정보를 한 파일에 밀어 넣는 대신 구조화된 위키 문서를 별도로 생성하고, CLAUDE.md나 AGENTS.md에는 위키 참조 링크와 사용법만 남겨둔다. 에이전트는 작업할 때 필요한 페이지만 찾아 읽으면 된다.

설치 및 실행 방법

설치와 사용법은 npm 명령어로 간단히 끝난다.

터미널에서 npm install -g openwiki 명령어로 전역 설치한 뒤, 프로젝트 폴더로 이동해 openwiki --init 을 실행하면 된다. 모델 제공자와 API 키를 입력하면 에이전트가 저장소를 탐색해 위키를 만든다.

지원 모델은 오픈소스와 상용 모델을 아우른다. OpenRouter, Fireworks, Baseten, OpenAI, Anthropic을 지원하며, 기본값은 OpenRouter 기반의 오픈 모델로 설정되어 있다.

내부적으로 DeepAgents 기반으로 구축되어 LangSmith 트레이싱도 바로 쓸 수 있다. API 키를 등록하면 문서 생성 및 업데이트 과정에서 에이전트가 어떤 추론을 거쳤는지 추적 가능하다.

오픈소스 커뮤니티의 확장 작업도 빠르게 진행 중이다. 일례로 MIT 라이선스로 공개된 pi-openwiki는 Pi 터미널 하네스용 확장 프로그램으로, 명령어 기반으로 아키텍처 문서를 생성하고 질문을 던질 수 있게 지원한다.

깃 변경 사항과 동기화하기

문서는 만드는 것보다 최신 상태를 유지하는 게 훨씬 까다롭다. OpenWiki는 GitHub Action을 통해 이 작업을 자동화한다.

하루 한 번 주기로 GitHub Action을 설정해 두면, OpenWiki가 지난 실행 이후 새로 병합된 커밋을 확인한다. git diff를 분석해 코드 변경점을 파악한 다음, 영향받은 위키 페이지만 골라서 갱신한다.

개발자가 일일이 문서를 수정할 필요 없이 백그라운드 CI에서 최신 상태가 유지된다. 코딩 에이전트는 늘 최신 코드에 맞춘 위키를 읽고 작업을 수행할 수 있다.

현재 오픈소스로 누구나 사용 가능하며, GitHub의 langchain-ai/openwiki 저장소나 npm을 통해 바로 설치할 수 있다.

왜 중요한가

중대형 프로젝트에서 AI 코딩 도구를 적극적으로 쓴다면 바로 도입해 볼 만하다. 날이 갈수록 비대해지는 CLAUDE.md의 용량을 획기적으로 줄이면서도 에이전트에게 필요한 장기 기억을 제공하기 때문이다.

프롬프트 하나에 모든 규격과 설계를 쏟아붓던 방식에서, 깃 변경 이력과 연동되는 외부 위키를 동적으로 검색하는 방식으로 전환하는 것은 매우 합리적인 흐름이다. 복잡한 전용 플랫폼을 강제하지 않고 익숙한 깃과 마크다운 환경 안에서 문제를 깔끔하게 풀어냈다.