OpenWiki

OpenWiki

코딩 에이전트가 더 빠르게 작업하도록 에이전트 위키를 쓰고 유지 관리하는 CLI

OpenWiki는 코드베이스나 개인 지식에 대한 Markdown 위키를 쓰고 유지 관리하는 오픈소스 CLI예요. 위키는 아키텍처, 통합, 평가, 워크플로 같은 세부 사항을 포착하여 코딩 에이전트가 매 작업마다 저장소를 재발견하는 대신 내구성 있는 컨텍스트로 사용할 수 있게 합니다.

이는 에이전트 작업을 토큰 측면에서 더 빠르고 저렴하게 만듭니다: 에이전트는 먼저 선별된 위키를 읽고, 더 많은 세부 사항이 필요한 곳에서만 소스를 검사합니다. 인간도 같은 Markdown(및 로컬 시각화 도구)을 탐색할 수 있지만, 주요 대상은 에이전트입니다.

OpenWiki는 Deep Agents 위에 구축되며 LangSmith로 트레이싱을 지원합니다.

출처: 문서

본문

시작하기 (Get started)

CLI를 설치한 다음 현재 저장소의 문서를 초기화하세요:

npm install -g openwiki
openwiki --init

빠른 시작에서 모델 프로바이더를 선택하고, 문서를 생성하고, 최신 상태로 유지하는 법을 확인하세요. 독립형 모델 세션 대신 Codex, Claude Code, OpenCode 또는 Cursor 안에서 OpenWiki를 실행하려면 코딩 에이전트 통합을 참고하세요.

모드 (Modes)

OpenWiki에는 두 가지 모드가 있습니다:

모드 명령 출력 사용 시기
코드 (기본) openwiki / openwiki code 현재 저장소의 openwiki/ 저장소 컨텍스트와 코딩 에이전트용 문서를 원할 때
개인 (Personal) openwiki personal ~/.openwiki/wiki 구성된 소스에서 로컬 개인 브레인을 원할 때

Bare openwiki --init과 openwiki --update는 코드 모드로 실행됩니다. 개인 위키에는 openwiki personal --init 또는 openwiki personal --update를 사용하세요.

기능 (Capabilities)

  • 저장소 위키 (/oss/openwiki/code-mode): openwiki/ 아래 Markdown 문서를 생성한 다음 AGENTS.md와 CLAUDE.md에 연결해 코딩 에이전트가 찾게 하기.
  • 코딩 에이전트 통합 (/oss/openwiki/integrations): 호스트 모델과 저장소 도구를 사용해 Codex, Claude Code, OpenCode, Cursor 안에서 OpenWiki 실행.
  • 개인 브레인 (/oss/openwiki/personal-mode): git 저장소, Custom MCP, Gmail, Notion, 웹 검색, Hacker News, X/Twitter에서 로컬 위키 구축.
  • 근거 기반 주장 (Grounded Claims) (/oss/openwiki/code-mode#grounded-claims): 핵심 사실을 버전 관리된 소스 증거로 추적하고 그 증거가 바뀌면 페이지를 새로고침.
  • 자동 업데이트 (/oss/openwiki/automate-updates): GitHub Actions, GitLab CI, Bitbucket Pipelines에서 문서를 새로고침하고 콘텐츠가 바뀌면 PR 열기.
  • 모델 프로바이더 (/oss/openwiki/providers): OpenAI, Anthropic, Gemini, Bedrock, OpenRouter, GitHub Copilot 및 기타 프로바이더를 기본으로 사용.
  • 오픈 지식 포맷 (/oss/openwiki/code-mode#open-knowledge-format): 프론트매터, 인덱스, 연결된 개념이 있는 OKF v0.2 Markdown 번들 방출.
  • LangSmith 트레이싱 (/oss/openwiki/quickstart#trace-with-langsmith): LangSmith로 문서 실행 트레이싱.

다음 단계 (Next steps)

  • 빠른 시작: OpenWiki 설치, 프로바이더 구성, 첫 위키 생성.
  • CLI 레퍼런스: 명령, 플래그, 커넥터 서브커맨드 검토.

더 알아보기