개요
OpenKnowledge는 마크다운 파일을 Notion이나 Google Docs처럼 편집하면서 Claude·Codex 같은 AI 에이전트와 함께 사용할 수 있게 만든 로컬 마크다운 에디터다. 게시글은 지식 베이스, LLM 위키, 스펙 문서, 노트를 대상으로 하며 데이터가 사용자 컴퓨터에 남고 무료로 사용할 수 있다고 소개한다. 마크다운의 텍스트 기반 버전 관리와 이식성을 유지하면서 WYSIWYG 편집을 제공하고, 기존 마크다운·MDX 폴더나 Obsidian Vault를 열 수 있다. Claude Code, Cursor, Codex 등의 하네스를 감지해 MCP와 스킬 설정을 프로젝트에 연결하는 점을 주요 특징으로 설명한다.
핵심 포인트
-
WYSIWYG 마크다운 편집: 원본은 마크다운 파일로 유지하면서 서식이 실시간으로 보이는 편집 경험을 제공한다.
-
AI 에이전트 협업: Claude, Codex, Cursor, OpenCode와 문서를 함께 편집할 수 있으며 MCP·CLI를 통한 다른 하네스 연동도 지원한다고 설명한다.
-
LLM Wiki 기능: MCP, 스킬, 에이전트 검색을 내장해 LLM 위키, 에이전트의 세컨드 브레인, 지식 그래프 용도로 사용할 수 있고 스타터 팩에 LLM 위키 템플릿을 포함한다.
-
Git 기반 동기화와 공유: git과 GitHub을 이용한 팀 공유 및 자동 동기화를 선택적으로 켤 수 있다.
-
사용 환경과 실행 방식: macOS는 데스크톱 앱을 사용하고, Linux·Windows·Intel Mac은 Node.js 24 이상과 git을 바탕으로 CLI에서 로컬 웹 앱을 실행한다. 게시글의 예시는 다음과 같다.
npm install -g @inkeep/open-knowledge cd your-project ok init ok start --open -
라이선스: 프로젝트는
GPL-3.0-or-later로 공개되어 있으며, 배포 시 GPL의 카피레프트 조건을 확인해야 한다.
공식 홈페이지 (2026-10-04 확인)
openknowledge.ai는 스스로를 “사람과 에이전트를 위한 리치 텍스트 에디터 겸 지식 베이스”로 소개한다. 게시글에 없던 내용은 다음과 같다.
- 에디터: 겉은 Notion 같은 편집기지만 내부는 마크다운이다. Callout·Accordion·Tabs·Mermaid·이미지·비디오 컴포넌트, 표와 다이어그램, iframe으로 넣는 임베드 HTML(앱·미리보기·시각화), 템플릿을 지원한다.
- 에이전트용 기능 3가지: Agent Skills(에이전트가 지식 베이스를 탐색·편집·확장하는 법을 기본으로 안다), Native MCP(Claude·Cursor·Codex에 연결), Agentic Search(임베딩과 계층형 RAG로 알맞은 문서를 찾는다)
- 용도 3가지: 팀 지식 베이스, 코드 옆에 두는 엔지니어링 스펙·PRD·로드맵, 에이전트가 읽고 쓰는 공유 “에이전트 브레인”(세션 간 영속 메모리)
- 공유: 문서나 프로젝트를 1클릭으로 공유하고, 동기화는 git으로 하므로 히스토리와 소유권이 사용자에게 남는다.
- 다운로드: 모든 플랫폼용 배포 페이지(openknowledge.ai/download)를 따로 둔다.
왜 중요한지
OpenKnowledge는 일반적인 노트 앱보다 마크다운 파일과 AI 에이전트의 공동 편집 흐름을 앞세운다. 따라서 로컬 파일 기반 지식 관리와 Claude Code·Codex·MCP를 연결하려는 사용자가 기존 폴더나 Vault를 유지한 채 검토할 수 있는 선택지로 소개된다. 다만 이 문서는 PyTorchKR 게시글의 설명을 요약한 것이므로 실제 지원 기능과 운영 조건은 공식 문서와 저장소에서 확인해야 한다.
후속으로 볼 링크와 키워드
- 원문: https://discuss.pytorch.kr/t/openknowledge-claude-codex-llm-wiki/11222
- 공식 홈페이지: https://openknowledge.ai
- 공식 문서: https://openknowledge.ai/docs/get-started/overview
- GitHub 저장소: https://github.com/inkeep/open-knowledge
- 관련 위키: moc-llm-wiki, moc-ai-coding, codex, mcp, 2026-09-26-news-hada-topic-34251(AI에 이해를 맡기지 않고 직접 쓰는 두 번째 뇌 — LLM 위키와 반대 방향의 선택)
- PyTorchKR 관련 글: LLM Wiki, Open Knowledge Format, Obsidian Skills, obsidian-second-brain, claude-obsidian
- 키워드:
local-first,Markdown,MDX,WYSIWYG,MCP,agentic search,LLM Wiki,GitHub,GPL-3.0-or-later