ONEDEV

open-knowledge

Document to MarkdownskillTypeScript

★ 4,226주당 +70조회 4

무엇인가

OpenKnowledge는 마크다운 기반 지식베이스(LLM 위키, 세컨드 브레인, 스펙, 노트)에서 에이전트가 문서를 검색·작성·연결하는 절차를 규율하는 스킬 묶음이다. 단순 편집기가 아니라 MCP 서버와 CLI, 스킬을 함께 제공하여 에이전트가 지식베이스 구조를 이해하고 일관된 형식으로 문서를 생성하도록 규칙을 주입한다. 대상 문제 영역은 문서 검색, 위키 링크 관리, 마크다운 작성, 지식 그래프 탐색이다.

어떻게 동작하나

동작 방식은 MCP(Model Context Protocol)와 스킬 파일, CLI로 구성된다. `ok init`이 프로젝트를 스캐폴딩하고 감지된 에이전트 하네스(Claude Code, Claude Desktop, Cursor, Codex, OpenCode, OpenClaw)에 MCP 설정과 스킬을 설치한다. 스킬은 SKILL.md 형식으로 배치되어 에이전트가 자동 로드하거나 MCP 도구 호출로 발동한다. 규칙 내용은 에이전트 검색(agentic search), 문서 작성, 위키 링크 생성, 검색 절차를 포함한다.

무엇과 다른가

직접 작성한 프롬프트나 단일 CLAUDE.md와 달리, OpenKnowledge는 편집기·파일 탐색기·검색·탭·그래프 위키 링크 뷰어·git 동기화를 포함한 통합 환경을 제공한다. MCP 서버가 파일 시스템과 지식 그래프에 접근하는 도구를 노출하고, 스킬이 그 도구를 사용하는 절차를 정의한다. 대안인 Obsidian + 수동 프롬프트나 일반 마크다운 폴더와 비교할 때, 에이전트 연동이 기본 제공된다.

어떻게 쓰나

설치 경로는 두 가지다. 데스크톱 앱은 macOS, Windows 10+, Linux용 설치 파일을 제공한다. 웹 앱은 Node.js 24+와 git이 필요하며, `npm install -g @inkeep/open-knowledge` 후 프로젝트 폴더에서 `ok init`을 실행해 에이전트 연동을 설정하고 `ok start --open`으로 웹 편집기를 연다. 첫 사용은 마크다운 또는 mdx 파일이 있는 기존 폴더를 열면 된다. `ok init`이 Claude Code 등 감지된 하네스에 MCP와 스킬을 자동 설치한다.

전제와 한계

전제 조건은 웹 앱의 경우 Node.js 24+와 git이다. 지원 에이전트는 Claude Code, Claude Desktop, Cursor, Codex, OpenCode, OpenClaw이며, MCP/CLI를 통해 다른 하네스와도 연동 가능하다. 한계로는 마크다운 지식베이스 편집과 검색에 초점을 두므로 일반 코드 리팩터링이나 빌드 자동화 규칙은 제공하지 않는다. Intel Mac은 데스크톱 앱 대신 웹 앱을 사용해야 한다. 라이선스는 GPLv3 이상이다.

유사 도구