# OpenWiki - 코드베이스를 위한 에이전트용 문서를 작성하고 관리하는 CLI

> Clean Markdown view of GeekNews topic #31594. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=31594](https://news.hada.io/topic?id=31594)
- GeekNews Markdown: [https://news.hada.io/topic/31594.md](https://news.hada.io/topic/31594.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2026-07-20T09:31:01+09:00
- Updated: 2026-07-20T09:31:01+09:00
- Original source: [github.com/langchain-ai](https://github.com/langchain-ai/openwiki)
- Points: 14
- Comments: 3

## Topic Body

- **에이전트 전용**으로 제작된 문서화 도구로, 코드베이스나 목적별 메모리용 위키를 작성/유지  
- 내장 커넥터 또는 Git 저장소를 통해 로컬 지식 소스를 가져와 하나의 **로컬 위키로 통합**  
- **두 가지 모드** 제공  
  - **Personal 모드**: 로컬 Repo,Gmail,Notion,Web Search,Hacker News,X 등을 소스로 `~/.openwiki/wiki`에 개인 브레인 위키 구축  
  - **Code 모드**: 현재 코드베이스용 저장소 문서를 `openwiki/`에 생성  
- **CI 연동으로 문서 자동 갱신**, GitHub Actions/GitLab CI용 예시 워크플로를 제공해 문서 갱신 PR/merge request를 자동 생성  
- **Google Open Knowledge Format(OKF) v0.1** 번들을 두 모드 모두에서 출력, 개념 문서는 `type` 필드를 가진 YAML front matter를 갖고 Markdown 링크로 관계 표현  
- 각 code 실행 시 저장소 루트에 `AGENTS.md`와 `CLAUDE.md`를 유지, 코딩 에이전트가 컨텍스트 검색 시 위키를 참조하도록 유도  
  - 기존 파일이 있으면 `<!-- OPENWIKI:START -->…<!-- OPENWIKI:END -->` 블록만 갱신하고 나머지는 보존  
- **로컬 커넥터**로 Git 저장소,Notion,Gmail,X,Web Search,Hacker News 수집 지원, 동일 커넥터를 여러 인스턴스로 구성 가능  
- **다양한 추론 프로바이더 지원**: OpenAI, OpenRouter, Gemini(AI Studio), Gemini Enterprise(Vertex AI), Nebius Token Factory, Fireworks, Baseten, NVIDIA NIM, OpenAI 호환, AWS Bedrock, Anthropic  
  - 온보딩 기본값은 OpenAI의 `gpt-5.6-terra`, ChatGPT 로그인/IAM 자격증명/Google ADC 등 프로바이더별 인증 방식 제공  
- **익명 텔레메트리**를 기본 수집(명령/결과/프로바이더/커넥터 이름 수준)하되, 파일 내용/자격증명/프롬프트/모델 출력/IP는 수집하지 않으며 `OPENWIKI_TELEMETRY_DISABLED=1` 또는 `DO_NOT_TRACK=1`로 비활성화 가능   
- `npm install -g openwiki`로 설치  
- MIT 라이선스

## Comments



### Comment 62092

- Author: laeyoung
- Created: 2026-07-20T17:09:39+09:00
- Points: 1

써보려고 했는데, `익명 텔레메트리를 기본 수집(명령/결과/프로바이더/커넥터 이름 수준)하되` 부분이 좀 아쉽긴 하네요. 끌 수는 있다고 하지만, 내용을 잘 안보고 그냥 기본으로 쓰는 사람이 많아 보이긴 하는데.

### Comment 62099

- Author: superl3
- Created: 2026-07-20T19:13:14+09:00
- Points: -1
- Parent comment: 62092
- Depth: 1

OPENWIKI_TELEMETRY_DISABLED=1 또는 DO_NOT_TRACK=1로 비활성화 가능  
이라는데 이건 믿지 않으시는 건가요?

### Comment 62105

- Author: laeyoung
- Created: 2026-07-20T21:54:46+09:00
- Points: 1
- Parent comment: 62099
- Depth: 2

끌 수는 있지만, default가 opt-in이라, default로 쓰는 사람이 많을 거 같아서요.  
  
동료나 친구에게 소개해주는걸 상상해보면, "OpenWiki 좋으니까 써봐"라고 하지, "OpenWiki 좋은데, OPENWIKI_TELEMETRY_DISABLED=1 또는 DO_NOT_TRACK=1 로 데이터 수집 비활성화 가능하니, 그거 켜놓고 써봐"라고 하진 않을테니까요ㅠ  
  
인데 제가 `명령`과 `결과`를 Prompt와 Output으로 인지 했었는데요. 원문을 다시 보니, 아니군요. 그럼 괜찮을지도?!