OpenKnowledge

OpenKnowledge는 Claude, Codex, Cursor와의 통합 기능을 갖춘 아름답고 로컬 우선(local-first) 방식의 마크다운(markdown) 에디터이자 LLM 위키(wiki)입니다.

이 에디터는 완전한 WYSIWYG(What You See Is What You Get)를 지원하여, 마크다운을 편집하는 것이 Google Doc이나 Notion 페이지를 편집하는 것처럼 느껴지도록 합니다.

팀 기반 협업을 위한 공유 및 자동 동기화 기능은 git을 통해 지원됩니다.

설치 (Install)

macOS: 데스크톱 앱을 다운로드하세요 — DMG 파일을 열고 Open Knowledge를 Applications 폴더로 드래그한 뒤 실행하세요. 최신 릴리스.

Linux 또는 Intel Mac: CLI를 통해 로컬 웹 앱으로서 동일한 에디터를 실행하세요 (Windows는 아직 지원되지 않습니다) (Node.js 24+ 필요):

npm install -g @inkeep/open-knowledge
cd your-project
ok init          # 프로젝트 스캐폴딩(scaffold) + Claude Code, Cursor, Codex 연결
...

일반적인 사용법에 대한 문서는 다음과 같습니다: https://openknowledge.ai/docs.

기여 (Contributions)

공개적인 풀 리퀘스트(pull requests)를 환영합니다. 이곳에 공개 PR이 열리면, 자동화 시스템이 검토 및 병합을 위해 내부 모노레포(monorepo)로 이를 미러링합니다.

자세한 내용은 CONTRIBUTING.md를 참조하세요.

필수 요구 사항 (Prerequisites)

• Bun 1.3.13 이상 (.bun-version에 고정됨)
• Node.js 24 이상 (.node-version에 고정됨)
• Git

Node 버전 관리자를 사용하는 경우, fnm install, volta install node@24, 또는 mise install을 사용하여 Node 24를 고정하세요. 이전 버전의 Node는 bun install 도중 engines 체크에서 실패합니다.

빠른 시작 (Quick Start)

bun install
bun run check

앱을 로컬에서 실행하기:

bun run --filter @inkeep/open-knowledge-app dev

문서 사이트를 로컬에서 실행하기:

cd docs
bun run dev

모노레포 레이아웃 (Monorepo Layout)

• packages/app - 웹 앱 및 에디터 UI
• packages/cli - 명령줄 인터페이스(command-line) 엔트리포인트
• packages/core - 공유 도메인 로직
• packages/desktop - Electron 데스크톱 앱
• packages/plugin - 에이전트 통합 패키지
• packages/server - 로컬 서버
• docs - 문서 사이트

개발 (Development)

bun run format
bun run lint
bun run typecheck
...

라이선스 (License)

OpenKnowledge는 GNU General Public License v3.0 or later (GPL-3.0-or-later)에 따라 라이선스가 부여됩니다.