OpenKnowledge: Claude, Codex와 함께 편집하는 로컬 마크다운 에디터 겸 LLM Wiki

읽을거리&정보공유
, , , , , ,
1

OpenKnowledge: Claude, Codex와 함께 편집하는 로컬 마크다운 에디터이자 LLM 위키

OpenKnowledge 소개

OpenKnowledge는 마크다운 파일을 Notion이나 구글 문서처럼 편집하면서, 그 파일들을 Claude·Codex 같은 AI 에이전트와 함께 다룰 수 있게 해 주는 로컬 마크다운 에디터입니다. 지식 베이스, LLM 위키, 스펙 문서, 노트를 대상으로 하며, 모든 데이터는 사용자의 컴퓨터에 남고 무료로 쓸 수 있습니다.

개발사인 inkeep은 이 도구를 "Notion과 VS Code가 만난 것"에 비유합니다. 마크다운의 이식성과 텍스트 기반 버전 관리는 그대로 유지하면서, 편집 경험은 서식이 실시간으로 보이는 완전한 WYSIWYG를 제공한다는 뜻입니다. 기존 코드베이스, 위키, Obsidian 볼트(Vault)처럼 마크다운이나 mdx 파일이 있는 폴더를 그대로 열어 사용할 수 있습니다.

OpenKnowledge가 다른 노트 앱과 구분되는 지점은 처음부터 AI 에이전트와의 협업을 전제로 설계됐다는 데 있습니다. 컴퓨터에 설치된 에이전트 하네스(Claude Code, Cursor, Codex 등)를 자동으로 감지해 프로젝트에 MCP와 스킬 설정을 붙여 주고, 에이전트가 문서를 검색하고 편집할 수 있는 통로를 열어 줍니다.

OpenKnowledge의 핵심 기능

OpenKnowledge의 핵심 기능을 정리한 개념도
OpenKnowledge의 핵심 기능을 정리한 개념도1536×1024 274 KB

OpenKnowledge가 내세우는 기능은 크게 네 갈래로 정리됩니다.

  • 완전한 WYSIWYG 편집: 마크다운 파일을 편집하는 경험이 구글 문서나 Notion 페이지를 다루는 것과 같도록 만들어, 원본은 여전히 텍스트 마크다운으로 저장하면서도 서식을 실시간으로 보여 줍니다.
  • AI 협업 편집: Claude, Codex, Cursor, OpenCode와 함께 문서를 편집할 수 있고, MCP나 CLI를 통해 다른 임의의 하네스·에이전트와도 연동됩니다.
  • 에이전트 검색과 LLM 위키: MCP, 스킬(skills), 에이전트 검색(agentic search)이 기본 내장되어 LLM 위키, 에이전트의 세컨드 브레인, 지식 그래프 용도로 쓸 수 있습니다. 시작용 스타터 팩에는 LLM 위키 템플릿도 포함되어 있습니다.
  • Git 동기화와 팀 공유: 내부적으로 git과 GitHub을 사용해, 코드를 몰라도 팀 공유와 자동 동기화를 켤 수 있습니다.

이 밖에도 파일 탐색기, 검색, 탭, 위키 링크를 시각화하는 그래프 뷰어를 갖춘 macOS 앱과 웹 UI를 제공하며, 엔지니어링 스펙이나 시각화 보고서를 쓸 때 쓰는 임베드형 HTML과 리치 컴포넌트, 터미널을 선호하는 사용자를 위한 macOS 앱 내장 TUI도 함께 들어 있습니다.

OpenKnowledge 설치 및 사용법

macOS 사용자는 데스크톱 앱을 내려받아 DMG를 열고 OpenKnowledge를 응용 프로그램 폴더로 옮긴 뒤 실행하면 됩니다. Linux, Windows, 인텔 맥에서는 같은 에디터를 CLI로 로컬 웹 앱처럼 실행합니다. 이 경로는 Node.js 24 이상과 git이 필요합니다.

npm install -g @inkeep/open-knowledge
cd your-project
ok init          # 프로젝트 구성 + AI 에디터(Claude Code, Cursor, Codex 등) 연동
ok start --open  # 웹 에디터를 띄우고 브라우저에서 열기

사용법은 단순합니다. 마크다운이나 mdx 파일이 든 폴더를 열면 되고, 아무것도 없는 상태에서 스타터 팩으로 새로 시작할 수도 있습니다. 앱은 컴퓨터에서 감지한 에이전트 하네스에 맞춰 프로젝트를 MCP·스킬 설정으로 자동 초기화하며, git 동기화와 공유는 필요할 때만 선택적으로 켤 수 있습니다. 일반 사용법 문서는 OpenKnowledge 공식 문서에 정리되어 있습니다.

OpenKnowledge의 라이선스

OpenKnowledge는 GNU General Public License v3.0 이상(GPL-3.0-or-later)으로 공개되어 있습니다. GPL은 카피레프트(copyleft) 라이선스이므로, 이 코드를 포함하거나 파생한 저작물을 배포할 때는 동일하게 GPL-3.0 이상으로 소스를 공개해야 합니다.

:house: OpenKnowledge 공식 홈페이지

:books: OpenKnowledge 문서 사이트

:github: OpenKnowledge 프로젝트 GitHub 저장소

더 읽어보기



이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. :hugs:

:pytorch:파이토치 한국 사용자 모임:south_korea:이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일:love_letter:로 보내드립니다! 텔레그램(Telegram)이나 Slack/Discord/Teams/Dooray/GoogleChat 등으로도 새 글 알림을 받으실 수 있습니다. :smiley:

:wrapped_gift: 아래:down_right_arrow:쪽에 좋아요:+1:를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ :star_struck: