OpenWiki — Hyperbook 코드베이스 위키 시스템

개요

OpenWiki (LangChain, v0.1.2)는 AI 에이전트가 코드베이스를 읽고 마크다운 위키를 자동 생성·유지하는 CLI 도구다. Hyperbook에서는 Google Gemini 2.5 Flash를 provider로 사용한다.

설치 위치

services/openwiki/
├── run.sh       # Gemini 래퍼 스크립트
└── README.md    # 서비스 설명

.openwikiignore  # 제외 경로 (시크릿·대용량 파일)
openwiki/        # 생성된 위키 파일들 (이 디렉토리)
CLAUDE.md        # <!-- OPENWIKI:START --> 섹션 자동 추가됨
AGENTS.md        # openwiki 안내 섹션
.github/workflows/openwiki-update.yml  # 일일 자동 업데이트

설정

Provider: Gemini (openai-compatible)

# ~/.env
GEMINI_API_KEY=AIza...  # Google AI Studio 발급

# services/openwiki/run.sh
export OPENWIKI_PROVIDER=openai-compatible
export OPENAI_COMPATIBLE_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai/
export OPENAI_COMPATIBLE_API_KEY=$GEMINI_API_KEY
export OPENWIKI_MODEL_ID=gemini-2.5-flash
export OPENWIKI_TELEMETRY_DISABLED=1

.openwikiignore (주요 제외 항목)

.env, *.pem, *.key          # 시크릿
*.db, *.tar.gz, node_modules # 대용량
.claude/, *.jsonl            # 세션 데이터
services/ttyd/index.html     # 409K 토큰 초과
openwiki/                    # 재귀 방지

사용법

cd ~/hyperbook

# 위키 최초 생성 (인터랙티브 설정 포함)
bash services/openwiki/run.sh --init

# 위키 업데이트
bash services/openwiki/run.sh --update

# 인터랙티브 채팅
bash services/openwiki/run.sh

# 그래프 시각화 (브라우저)
bash services/openwiki/run.sh visualize

에이전트 활용법

생성된 위키는 일반 마크다운이므로 Read 도구로 직접 참조:

Read: ~/hyperbook/openwiki/quickstart.md    # 전체 구조 파악
Read: ~/hyperbook/openwiki/architecture.md  # 아키텍처
Read: ~/hyperbook/openwiki/services.md      # 서비스 목록
Read: ~/hyperbook/openwiki/agents.md        # 에이전트 정보
Read: ~/hyperbook/openwiki/thesis-web.md    # thesis-web API

알려진 제약

GitHub Actions 자동 업데이트

.github/workflows/openwiki-update.yml — 매일 08:00 UTC 실행: - Provider: OpenRouter (z-ai/glm-5.2) - PR 자동 생성: openwiki/update 브랜치

EOS 운영 책임

OpenWiki 업데이트 요청은 ntfy roops-eos 또는 사령관 경유. 대규모 코드 변경·신규 서비스·에이전트 합류 시 --update 실행.

thesis 논문

자세한 설치·설정 가이드: OpenWiki 구축·목적·사용법