발표에서 확인된 핵심 사실
로컬 지식 소스를 내장 커넥터나 Git 저장소로 통합해 에이전트 전용 위키를 구축하는 CLI(명령줄 인터페이스) 도구가 도입되었다. 이를 통해 개발자는 에이전트가 참조할 코드베이스나 목적별 메모리 관리 체계를 로컬 환경에서 직접 구축하고 제어할 수 있다. OpenWiki는 에이전트가 스스로 문서를 작성하고 유지하도록 설계된 전용 문서화 도구다. 내장 커넥터 또는 Git 저장소를 통해 로컬에 분산된 지식 소스를 가져와 하나의 로컬 위키로 통합하는 기능을 수행하며, 이를 통해 에이전트 전용의 지식 기반을 마련한다.
추론 엔진은 OpenAI, OpenRouter, Gemini(AI Studio), Gemini Enterprise(Vertex AI), Nebius Token Factory, Fireworks, Baseten, NVIDIA NIM, AWS Bedrock, Anthropic 등 다양한 프로바이더를 지원하며 OpenAI 호환 인터페이스도 함께 포함한다. 온보딩 과정의 기본 모델은 OpenAI의 gpt-5.6-terra로 설정되어 있다. 인증 체계는 각 프로바이더의 특성에 맞게 세분화하여 제공한다. ChatGPT 로그인과 IAM(Identity and Access Management, 식별 및 액세스 관리) 자격증명, Google ADC(Application Default Credentials) 등을 통해 인증을 수행한다. 사용자는 보유한 API 환경과 인증 방식에 맞춰 추론 모델을 선택해 위키 관리 기능을 운용한다.
기술이 실제로 작동하는 방식
Gmail, Notion, X, 개발자 커뮤니티, Web Search 및 로컬 Repo를 소스로 활용하는 Personal 모드와 현재 코드베이스용 문서를 생성하는 Code 모드가 구분되어 작동한다. Personal 모드는 외부 서비스와 로컬에서 수집한 정보를 ~/.openwiki/wiki 경로에 저장해 개인 브레인 위키를 구축하며, Code 모드는 현재 작업 중인 코드베이스를 분석해 openwiki/ 디렉토리에 저장소 전용 문서를 생성한다. 사용 목적에 따라 지식 소스의 성격과 저장 경로를 물리적으로 분리해 관리함으로써 개인 지식과 프로젝트 문서를 독립적으로 운용하는 구조다.
CI(지속적 통합) 연동 기능은 GitHub Actions와 GitLab CI를 통해 문서 갱신 PR(Pull Request, 풀 리퀘스트)이나 merge request를 자동으로 생성한다. 도구에서 제공하는 예시 워크플로를 적용하면 문서 갱신 과정이 자동화되어 지식 기반을 항상 최신 상태로 유지한다. 이는 개발자가 일일이 문서를 수정하는 번거로움 없이 코드 변경 사항이 문서에 즉각 반영되도록 하는 자동화 공정을 수행하는 것이다.
저장소 루트에 배치되는 AGENTS.md와 CLAUDE.md 파일은 코딩 에이전트가 컨텍스트를 검색할 때 위키를 참조하도록 유도하는 장치다. 각 코드 실행 시 해당 파일들을 유지함으로써 에이전트가 참조해야 할 지식 기반의 위치를 명시적으로 지정한다. 에이전트의 검색 경로를 제어해 필요한 컨텍스트를 정확히 찾아내게 함으로써, 에이전트가 위키에 기록된 최신 정보를 바탕으로 작업을 수행하게 하는 역할을 한다.
전역 설치 방식은 npm(Node Package Manager, 노드 패키지 매니저)을 통해 수행하며 아래 명령어로 실행한다.
npm install -g openwiki실제 적용 여부는 공식 저장소에 공개된 설치 명령과 실행 가이드를 통해 직접 판단한다.
사용법
> 공식 저장소 기준 설치·실행 방법이다.
npm install -g openwiki
# or
pnpm add -g openwikiopenwiki --init
