Show HN: OpenKnowledge – open source AI-first alternative to Obsidian/Notion

Who Should Read

Obsidian이나 Notion을 팀과 함께 쓰면서 AI 에이전트 통합, Git 버전관리, 벤더 종속 없는 지식 관리 환경을 원하는 개발자 및 팀 리드.

Core Mechanics

• OpenKnowledge는 마크다운 파일을 Google Doc이나 Notion처럼 WYSIWYG로 편집할 수 있는 로컬 우선 에디터다. 기술적으로는 마크다운 파일과 폴더 구조를 그대로 유지하면서 편집 경험만 개선했다.
• Claude, Codex, Cursor 데스크톱 앱과 협업 AI 편집이 가능하고, MCP(Model Context Protocol, AI 에이전트가 외부 도구를 쓰는 표준 프로토콜)와 CLI를 통해 어떤 AI 에이전트와도 연동할 수 있다.
• LLM Wiki, 에이전트 두 번째 뇌, Spec-driven development(사양 문서 기반 개발)를 위한 MCP, Skills, Agentic Search 기능이 기본 내장되어 있다.
• 팀 공유와 자동 동기화는 내부적으로 Git/GitHub를 사용해서 동작하기 때문에 별도 클라우드 서비스 없이도 버전 관리와 협업이 가능하다.
• macOS는 데스크톱 앱(.dmg)을 제공하고, Linux/Windows/Intel Mac은 CLI를 통해 로컬 웹앱으로 실행한다. Node.js 24 이상이 필요하고 `npm install -g @inkeep/open-knowledge`로 설치한다.
• `ok init` 명령 하나로 프로젝트 스캐폴딩과 Claude Code, Cursor, Codex 연동 설정이 자동으로 완료된다.
• 라이선스는 GPL-3.0으로 오픈소스이며, 공개 PR을 내부 모노레포로 미러링해서 리뷰하는 방식으로 기여를 받고 있다.
• Inkeep(AI 고객 지원 플랫폼 기업)이 만든 프로젝트로, 비즈니스 모델에 대한 커뮤니티 질문이 있었지만 명확한 답변은 나오지 않은 상태다.

Evidence

• 로컬 우선을 표방하면서도 로컬 LLM(Ollama 등 OpenAI 호환 API)과 연동이 안 된다는 비판이 있었다. 여러 댓글에서 OpenAI 호환 LLM 프로바이더 연결 옵션이 빠진 것을 아쉬워했고, 이게 채택의 걸림돌이 될 수 있다는 의견이 많았다.
• Claude, Codex, Cursor만 지원하는 이유에 대한 질문도 있었다. 한 사용자는 Obsidian에 opencode 구독을 쓰고 있는데 왜 지원 범위를 이 셋으로 제한했는지 물었고, 더 많은 AI 도구 지원 요청이 있었다.
• 비슷한 요구를 이미 pi.dev로 해결했다는 사용자가 있었다. `rcarmo/piclaw`라는 프로젝트에서 WYSIWYG 마크다운 에디터, 터미널, 마인드맵, 칸반 등을 통합해서 Obsidian을 완전히 대체했다는 실사용 경험이 공유됐다.
• 팀 지식베이스 공유 니즈를 정확히 짚었다는 반응이 있었다. Git으로 버전 관리하면서 비기술직 팀원도 쓸 수 있고, 비싼 클라우드 플랫폼에 종속되지 않는 도구를 오래 찾아왔다는 댓글이 있었고, MCP로 어떤 AI 채팅에서든 접근 가능한 점(아직 미흡하지만)도 긍정적으로 평가됐다.
• Skills 기능의 컨텍스트 크기 문제를 지적하는 의견이 있었다. 어차피 마크다운 폴더인데 Open Knowledge Skills가 꼭 필요한지 의문이고, Skills 파일이 커서 LLM 컨텍스트 창을 불필요하게 채운다는 실제 사용 중 발견한 문제점이 공유됐다.
• 'ok'라는 CLI 명령어가 PATH에 추가됐다는 알림 메시지가 너무 모호해서 뭔지 한참 몰랐다는 UX 피드백도 있었다. 제품 이름 'ok'가 일상 단어와 겹쳐서 혼란을 줄 수 있다는 지적이었다.

How to Apply

• Git 기반 팀 지식베이스를 만들고 싶은 경우, `npm install -g @inkeep/open-knowledge` 후 `ok init`을 실행하면 Claude Code, Cursor, Codex 연동 설정이 자동으로 잡혀서 팀원들이 AI 보조 편집을 바로 시작할 수 있다.
• AI 에이전트가 참조할 Spec 문서나 프로젝트 위키를 관리하는 경우, MCP 서버로 노출해두면 Claude나 Codex 같은 에이전트가 작업 중에 위키를 직접 검색하고 참조할 수 있어서 컨텍스트를 매번 붙여넣는 수고를 줄일 수 있다.
• Linux나 Windows 환경에서 사용하는 경우, 데스크톱 앱 대신 `ok start --open`으로 로컬 웹 에디터를 띄울 수 있다. Node.js 24 이상이 필요하므로 버전 확인 후 설치해야 한다.
• Notion처럼 쓰면서 벤더 종속을 피하고 싶은 경우, 파일이 실제 마크다운으로 저장되기 때문에 언제든 다른 도구로 마이그레이션하거나 Git 히스토리를 그대로 유지할 수 있다는 점을 활용할 수 있다.

Code Example

# 설치 및 초기화
npm install -g @inkeep/open-knowledge

cd your-project
ok init       # 프로젝트 스캐폴딩 + Claude Code, Cursor, Codex 자동 연동 설정
ok start --open  # 로컬 웹 에디터 실행 후 브라우저에서 열기

# macOS 데스크톱 앱은 DMG 다운로드 후 Applications 폴더로 드래그

Terminology

Related Papers

• Show HN: ctx – Search the coding agent history already on your machine

  Claude Code, Cursor, Codex 등 코딩 에이전트가 이전 세션의 논의·결정·실패 시도를 잊지 않도록 SQLite로 인덱싱해 재사용할 수 있게 해주는 오픈소스 CLI 도구다.

• Micro-Agent: Beat Frontier Models with Collaboration Inside Model API

  vLLM 팀이 단일 모델 API 호출 뒤에서 여러 모델이 협업하는 'Micro-Agent' 개념을 공개했습니다. 별도의 에이전트 코드 없이 라우터 레이어에서 모델 조합을 실행해 GPT-4급 결과를 더 저렴하게 낼 수 있다는 아이디어입니다.

• Ornith-1.0: self-improving open-source models for agentic coding

  Gemma 4와 Qwen 3.5를 기반으로 파인튜닝한 코딩 특화 오픈소스 모델로, RL(강화학습)을 통해 스캐폴드(에이전트 실행 구조)까지 함께 최적화하는 방식을 주장하지만, 커뮤니티에서는 벤치마크 과최적화에 불과하다는 의심을 받고 있다.

• Entity Binding Failures in Tool-Augmented Agents

  AI 에이전트가 올바른 도구를 선택해도 잘못된 대상에 실행하는 'Entity Binding 실패' 문제를 정의하고, 이를 막는 실행 정책을 평가한 논문.

• Herdr: Agent multiplexer that lives in your terminal

  여러 AI 코딩 에이전트(Claude, Codex 등)를 하나의 터미널에서 동시에 실행·관리할 수 있는 Rust 기반 오픈소스 툴로, tmux처럼 세션이 유지되고 SSH로 원격 접속도 가능해 멀티 에이전트 워크플로우를 크게 단순화해준다.

• Ornith-1.0: Self-scaffolding LLMs for agentic coding

  모델이 문제 풀이 전략(scaffold)을 직접 생성하고 개선하는 자기강화 학습 프레임워크를 적용한 오픈소스 코딩 특화 LLM으로, 9B 소형 모델부터 397B 대형 모델까지 라인업을 갖추고 SWE-Bench 등 주요 벤치마크에서 Claude Opus 4.7을 능가하는 성능을 보여줬다.

Related Resources

• OpenKnowledge GitHub 저장소
• OpenKnowledge 공식 문서
• piclaw - pi.dev 기반 Obsidian 대안 프로젝트
• Open Knowledge Foundation (OKFN)
• Google Open Knowledge Format 발표