OpenWiki의 개요
OpenWiki는 코딩 에이전트가 저장소를 조사해 openwiki/ 폴더에 연결된 Markdown 위키를 쓰고 이를 최신으로 유지하게 하는 LangChain 프로젝트입니다. 사실 진술마다 파일과 줄 범위 같은 버전 관리된 소스 근거를 가리키는 Grounded Claim으로 저장되므로, 업데이트는 근거가 바뀐 페이지만 다시 쓰고, 변경이 없는 업데이트는 모델을 전혀 호출하지 않습니다.
두 가지 방식으로 돕니다. 이미 쓰는 코딩 에이전트(Codex, Claude Code, OpenCode, Cursor, GitHub Copilot CLI, Kiro, IBM Bob, Antigravity, Oh My Pi, Pi) 안에서 그 에이전트의 모델 세션을 쓰거나, 모델 제공사 열네 곳을 지원하는 자체 Deep Agents 문서 에이전트 위의 독립 CLI로 돕니다. AGENTS.md 블록을 관리하고, MCP로 로컬 검색과 읽기 도구를 노출하고, 저장소 간 위키를 워크스페이스로 연결하며, Google의 Open Knowledge Format v0.2를 씁니다.
저장소는 2026년 6월 22일에 만들어졌고, MIT 라이선스이며, GitHub 스타는 약 17,600개입니다. npm 패키지는 0.7.2(2026년 10월 9일)이며 10월 마지막 주에 약 66,000회 다운로드됐습니다.
OpenWiki, 쓸 만한 가치가 있습니까?
OpenWiki는 생성된 문서 대부분을 가라앉히는 문제를 풉니다. 문서는 썩고, 아무도 어느 부분이 썩었는지 모릅니다. 사실마다 버전 관리된 소스 근거를 붙이므로, 다음 실행에서 재시도 처리에 관한 주장이 그 사이 옮겨 간 줄을 인용하고 있음을 알아채고 그 페이지만 모델에 돌려보낼 수 있습니다. 바뀌지 않은 저장소는 업데이트 비용이 없습니다. 검사가 모델 호출 전에 돌 기 때문입니다. 페이지는 하나씩 저장되므로 중단된 실행은 처음부터가 아니라 이어서 재개됩니다.
실용적인 이점은 연동 방식입니다. Claude Code나 Codex 안에서 돌면 에이전트의 인증된 세션과 도구를 빌리므로, 관리할 두 번째 API 키나 청구서가 없습니다. 조사와 작성은 에이전트가 하고, OpenWiki는 대기열, 주장 관리, 최종 색인을 맡습니다. MCP 검색과 읽기 도구는 로컬이고 읽기 전용이며 모델을 호출하지 않고, 관리되는 지침은 에이전트가 모든 작업 시작 때 위키를 불러오는 대신 구체적인 질문이 있을 때 찾아보게 합니다. 예약된 GitHub Actions, GitLab, Bitbucket 작업은 위키가 바뀌면 문서 풀 리퀘스트를 엽니다.
기본값은 살펴볼 만합니다. 텔레메트리가 켜져 있습니다. init이나 update마다 명령, 결과, 그리고 설정 시 제공사와 커넥터 이름을 담은 이벤트 하나를 보내며, 코드나 프롬프트는 절대 보내지 않습니다. OPENWIKI_TELEMETRY_DISABLED=1이나 DO_NOT_TRACK=1로 끕니다. 그래프 시각화 도구는 공개 CDN에서 라이브러리를 가져오므로 오프라인에서는 동작하지 않습니다. .openwikiignore로 경로를 읽지 않게 할 수 있지만, README는 에이전트가 테스트나 커밋 메시지로 무시된 영역을 여전히 추론할 수 있다고 적고 있습니다.
한계는 빠르게 움직이는 넉 달 된 프로젝트다운 것들입니다. 버전 0.7.2, 열린 이슈와 풀 리퀘스트 약 208개, 그리고 지금까지 주장 근거 연결은 저장소 코드만 다루며 개인 위키 커넥터(Notion, Gmail, Slack, X)나 LangSmith 트레이스는 다루지 않습니다. 매번 저장소를 프롬프트 하나에 묶는 Repomix와 비교하면, OpenWiki는 처음에 전체 생성 비용을 치르고 이후의 모든 질문과 점진적 업데이트에서 이를 돌려받습니다.
제 역할을 하는 곳
컨트롤 플레인, 데이터 플레인, 인프라 저장소를 맡은 플랫폼팀
세 코드베이스를 모두 불러오지 않고 에이전트가 저장소 간 질문에 답하게 하기
저장소마다 위키를 생성하고 openwiki link로 워크스페이스에 묶으면, 에이전트가 로컬 MCP 도구로 셋을 모두 검색합니다. Claude Code나 Codex로 돌리면 에이전트 자체 세션 외에 모델 청구가 늘지 않습니다.
온보딩 문서가 낡은 개발자 30명 규모 회사의 엔지니어링 매니저
누군가를 배정하지 않고 아키텍처 문서를 최신으로 유지하기
세분화된 토큰과 함께 예약된 GitHub Actions 워크플로를 추가하면, 주장이 낡을 때마다 문서 전용 풀 리퀘스트를 엽니다. 검토자는 다른 변경처럼 병합합니다. 변경이 없는 주에는 모델 호출이 없습니다.
크고 낯선 저장소에 합류한 스태프 엔지니어
오후 한나절에 코드베이스의 정확한 지도 얻기
Claude Code 연동을 설치하고 에이전트에게 소스와 테스트로 OpenWiki를 초기화하게 한 뒤, openwiki visualize로 Markdown 리더 옆에 그래프를 엽니다. 첫 생성에는 에이전 트 세션 하나 분량의 토큰이 든다고 예상하십시오.
도입 전 확인할 점
- 설정
- npm install -g openwiki(Node 22.22.0+), openwiki integrations install claude(또는 codex, cursor 등)를 실행하고, 에이전트를 재시작해 위키 초기화를 요청합니다. 독립 실행: openwiki --init이 제공사, 키, 모델 설정을 안내합니다.
- 연동
- 코딩 에이전트 호스트 열 개. 독립 CLI용 제공사 열네 곳으로, OpenAI(기본 gpt-5.6-terra), Anthropic, Bedrock, Vertex, Copilot, Ollama 같은 OpenAI 호환 엔드포인트 포함. GitHub, GitLab, Bitbucket용 CI 템플릿. 개인 위키용 Notion, Gmail, Slack, X, 웹 검색, Hacker News 커넥터.
- 데이터와 개인정보
- 위키와 주장은 저장소의 평범한 파일이고, 키는 ~/.openwiki/.env에 있습니다. 텔레메트리는 기본적으로 init이나 update마다 익명 이벤트 하나를 보내며, OPENWIKI_TELEMETRY_DISABLED=1로 거부합니다. 저장소 내용은 쓰는 모델 제공사나 호스트 에이전트로 갑니다. MIT 라이선스.
- 대규모 사용 시 비용
- 무료 소프트웨어입니다. 큰 저장소의 첫 생성이 비싼 단계입니다. 네이티브 실행은 최대 8페이지를 병렬로 문서화할 수 있고, 이후 업데이트는 근거가 바뀐 페이지에만 비 용을 냅니다. 코딩 에이전트 호스트를 쓰면 비용은 그 구독 안에 들어갑니다.
- 제한
- 0.7.2에서 열린 이슈와 풀 리퀘스트 약 208개. 호스트 기반 실행은 순차적이고 코드 위키만 다룸. 스트리밍 전용 게이트웨이는 스트리밍을 강제하지 않으면 빈 위키를 돌려줄 수 있음. OpenRouter 잔액이 낮으면 출력 상한 없이 402 오류가 날 수 있음.
좋은 점
- Grounded Claims가 사실마다 버전 관리된 소스 줄에 묶임
- 변경 없는 업데이트는 모델 호출을 완전히 건너뜀
- 열 개 코딩 에이전트 안에서 기존 세션으로 실행
- 연결된 저장소 전반의 로컬 읽기 전용 MCP 검색
아쉬운 점
- 텔레메트리 기본 활성
- 시각화 도구가 공개 CDN을 써서 오프라인 보기 불가
- 주장 근거 연결은 코드만 다루고 커넥터는 다루지 않음
- 1.0 이전, 열린 이 슈와 PR 약 208개
추천 대상
코딩 에이전트가 같은 코드베이스를 계속 다시 파악하고 있으며, 표류하지 않고 풀 리퀘스트로 스스로 갱신되는 위키를 원하는 팀.
OpenWiki 대안
OpenWiki: 자주 묻는 질문
- OpenWiki, 쓸 만한 가치가 있습니까?
- OpenWiki는 자기 문장 중 어느 것이 낡았는지 아는 첫 에이전트 작성 문서 도구이며, 그 덕에 생성된 문서가 남겨 둘 가치가 생깁니다. 평점은 5점 만점에 4.2점입니다.
- OpenWiki의 가격은 얼마입니까?
- MIT의 무료 오픈소스입니다. 모델 제공사에 직접 비용을 냅니다.
- OpenWiki의 단점은 무엇입니까?
- 텔레메트리 기본 활성; 시각화 도구가 공개 CDN을 써서 오프라인 보기 불가; 주장 근거 연결은 코드만 다루고 커넥터는 다루지 않음; 1.0 이전, 열린 이슈와 PR 약 208개.
- OpenWiki에 적합한 사람은 누구입니까?
- 코딩 에이전트가 같은 코드베이스를 계속 다시 파악하고 있으며, 표류하지 않고 풀 리퀘스트로 스스로 갱신되는 위키를 원하는 팀.
- 팀이나 프로덕션 환경에서 OpenWiki의 비용은 얼마입니까?
- 무료 소프트웨어입니다. 큰 저장소의 첫 생성이 비싼 단계입니다. 네이티브 실행은 최대 8페이지를 병렬로 문서화할 수 있고, 이후 업데이트는 근거가 바뀐 페이지에만 비용을 냅니다. 코딩 에이전트 호스트를 쓰면 비용은 그 구독 안에 들어갑니다.
- OpenWiki에 회사 데이터를 맡겨도 안전합니까?
- 위키와 주장은 저장소의 평범한 파일이고, 키는 ~/.openwiki/.env에 있습니다. 텔레메트리는 기본적으로 init이나 update마다 익명 이벤트 하나를 보내며, OPENWIKI_TELEMETRY_DISABLED=1로 거부합니다. 저장소 내용은 쓰는 모델 제공사나 호스트 에이전트로 갑니다. MIT 라이선스.
- OpenWiki의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Repomix, Graphify, code2prompt 및 claude-mem입니다.
답변 확인일: 2026년 10월 31일.
OpenWiki 개발사입니까? 이 평점을 사이트에 표시하십시오
