개요

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의 카피레프트 조건을 확인해야 한다.

왜 중요한지

OpenKnowledge는 일반적인 노트 앱보다 마크다운 파일과 AI 에이전트의 공동 편집 흐름을 앞세운다. 따라서 로컬 파일 기반 지식 관리와 Claude Code·Codex·MCP를 연결하려는 사용자가 기존 폴더나 Vault를 유지한 채 검토할 수 있는 선택지로 소개된다. 다만 이 문서는 PyTorchKR 게시글의 설명을 요약한 것이므로 실제 지원 기능과 운영 조건은 공식 문서와 저장소에서 확인해야 한다.

후속으로 볼 링크와 키워드