Repolode
langchain-ai

langchain-ai/openwiki

코드베이스의 근거 자료를 바탕으로 연결된 Markdown 위키를 작성하고 관리하는 CLI로, 코딩 에이전트와 개발자가 활용할 수 있습니다.

스타
17,785
포크
1,313
열린 이슈
175
마지막 커밋
4시간 전

어떤 프로젝트인가요?

OpenWiki는 저장소와 지식 소스를 연결된 Markdown 위키로 만들며, 위키는 일반 파일로 저장소 안에 유지됩니다. 코딩 에이전트는 이를 활용해 코드베이스를 파악하고 질문에 답하며 관련 프로젝트 전반에서 맥락을 찾을 수 있습니다. 독자는 같은 페이지를 둘러보거나 인터랙티브 노드 그래프로 볼 수 있습니다.

저장소 위키에서는 각 사실에 버전이 관리되는 소스 근거가 연결되므로, 코드가 바뀌면 OpenWiki는 영향을 받는 사실만 업데이트할 수 있습니다. 변경된 내용이 없으면 업데이트 과정에서 모델을 호출하지 않고, 실행이 중단되더라도 완료된 페이지부터 이어서 진행합니다.

Codex, Claude Code, Cursor, GitHub Copilot CLI 등 지원되는 코딩 에이전트 안에서 OpenWiki를 시작하거나, 원하는 모델 제공자를 선택해 독립형 CLI로 실행할 수 있습니다. 또한 Notion, Gmail, Hacker News 등의 커넥터에서 로컬 지식을 종합하는 개인 모드도 제공하며, CI에서 일정에 따라 실행해 문서 업데이트 PR을 열도록 설정할 수 있습니다.

핵심 기능

  • 01저장소 안에 편집하고 버전 관리할 수 있는, 서로 연결된 Markdown 위키를 생성합니다.
  • 02페이지의 사실을 소스 근거와 연결해 코드 변경의 영향을 받는 주장만 업데이트합니다.
  • 03여러 코딩 에이전트와 통합하고 MCP를 통해 검색 및 읽기 도구를 제공합니다.
  • 04여러 저장소를 워크스페이스로 연결해 프로젝트 간 검색을 지원합니다.
  • 05인터랙티브 그래프와 실시간 Markdown 리더를 갖춘 로컬 시각화 도구를 제공하며, 정적 내보내기도 지원합니다.
  • 06OpenAI 호환 로컬 엔드포인트를 포함해 다양한 모델 제공자를 지원합니다.

활용 사례

  • 코딩 에이전트가 규모가 크거나 익숙하지 않은 저장소를 파악할 수 있도록 최신 개요를 제공합니다.
  • 일정에 따라 CI에서 업데이트 PR을 열어 온보딩 및 아키텍처 문서를 최신 상태로 유지합니다.
  • 여러 저장소에 걸친 서비스를 검색 가능한 하나의 워크스페이스로 문서화합니다.
  • 생성된 문서와 함께 둘러볼 수 있는 아키텍처 그래프를 게시합니다.

빠른 시작

  1. 1

    npm으로 OpenWiki를 전역 설치합니다(Node.js 22.22.0 이상 필요)

    npm install -g openwiki
  2. 2

    코딩 에이전트를 연결합니다(Codex 예시이며, 다른 에이전트에는 각각 별도의 설치 명령이 있습니다)

    openwiki integrations install codex
  3. 3

    코딩 에이전트를 다시 시작하고 저장소를 연 다음, 소스 코드와 테스트를 바탕으로 OpenWiki를 초기화하도록 요청합니다

  4. 4

    브라우저에서 생성된 wiki를 인터랙티브 그래프로 살펴봅니다

    openwiki visualize

사용 전 알아둘 점

  • Node.js 22.22.0 이상이 필요합니다.
  • 가장 간편한 워크플로에는 지원되는 코딩 에이전트가 필요하며, 호스트 주도 실행은 저장소 코드 wiki만 지원하고 개인용 지식 베이스는 지원하지 않습니다.
  • Windows에서는 bun이 better-sqlite3 네이티브 종속성을 컴파일하는 방식으로 대체 실행될 수 있으며, 이 경우 Visual Studio Build Tools가 필요합니다.

Repolode 주간에 소개됨

포함된 컬렉션

토픽

자주 묻는 질문

openwiki은(는) 무엇인가요?
코드베이스의 근거 자료를 바탕으로 연결된 Markdown 위키를 작성하고 관리하는 CLI로, 코딩 에이전트와 개발자가 활용할 수 있습니다. OpenWiki는 저장소와 지식 소스를 연결된 Markdown 위키로 만들며, 위키는 일반 파일로 저장소 안에 유지됩니다. 코딩 에이전트는 이를 활용해 코드베이스를 파악하고 질문에 답하며 관련 프로젝트 전반에서 맥락을 찾을 수 있습니다. 독자는 같은 페이지를 둘러보거나 인터랙티브 노드 그래프로 볼 수 있습니다.
openwiki은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
openwiki은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
openwiki은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. openwiki의 마지막 커밋은 2026년 11월 6일입니다.
openwiki은(는) 어디에 사용할 수 있나요?
코딩 에이전트가 규모가 크거나 익숙하지 않은 저장소를 파악할 수 있도록 최신 개요를 제공합니다. 일정에 따라 CI에서 업데이트 PR을 열어 온보딩 및 아키텍처 문서를 최신 상태로 유지합니다. 여러 저장소에 걸친 서비스를 검색 가능한 하나의 워크스페이스로 문서화합니다. 생성된 문서와 함께 둘러볼 수 있는 아키텍처 그래프를 게시합니다.
openwiki는 어떻게 설치하나요?
npm으로 OpenWiki를 전역 설치합니다(Node.js 22.22.0 이상 필요): npm install -g openwiki 코딩 에이전트를 연결합니다(Codex 예시이며, 다른 에이전트에는 각각 별도의 설치 명령이 있습니다): openwiki integrations install codex 코딩 에이전트를 다시 시작하고 저장소를 연 다음, 소스 코드와 테스트를 바탕으로 OpenWiki를 초기화하도록 요청합니다 브라우저에서 생성된 wiki를 인터랙티브 그래프로 살펴봅니다: openwiki visualize
openwiki은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/langchain-ai/openwiki

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트