개요

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 게시글의 설명을 요약한 것이므로 실제 지원 기능과 운영 조건은 공식 문서와 저장소에서 확인해야 한다.

후속으로 볼 링크와 키워드