💻 필요한 컴퓨터 사양

⚡ 설치법

### 4-1. Quick Start

**macOS 데스크톱 앱 다운로드:**
[공식 웹사이트](https://openknowledge.ai)에 접속하여 macOS용 `.dmg` 파일을 다운로드한 후, 애플리케이션 폴더로 드래그 앤 드롭합니다.

**CLI 설치 및 프로젝트 초기화 (Linux, Windows, Intel Mac):**
```bash
npm install -g @inkeep/open-knowledge
cd your-project
ok init
```

### 4-2. 상세 설치

1. **사전 준비**: 로컬 환경에 Node.js(버전 24 이상)가 설치되어 있는지 확인합니다.
   ```bash
   node -v
   ```

2. **글로벌 패키지 설치**: npm을 이용해 OpenKnowledge CLI를 글로벌 환경에 설치합니다.
   ```bash
   npm install -g @inkeep/open-knowledge
   ```

3. **프로젝트 폴더 지정 및 초기화**: 마크다운 파일이 보관될 작업 디렉토리로 이동하여 프로젝트를 생성하고 AI 에이전트 연동 파일을 스캐폴딩합니다.
   ```bash
   cd /path/to/your/knowledge-base
   ok init
   ```

4. **웹 에디터 구동**: 로컬 서버를 열고 웹 브라우저에서 편집기를 실행합니다.
   ```bash
   ok start --open
   ```

📝 업데이트 노트

1. vv0.53.38/13/2026

   이번 업데이트에서는 슬래시(/) 명령어를 통해 에이전트의 기능을 더 쉽고 빠르게 호출할 수 있는 기능이 추가되었어요. 명령어 선택기가 도입되어 복잡한 입력 없이도 원하는 기능을 직관적으로 찾아 사용할 수 있어 연구 워크플로우가 훨씬 간결해집니다. 또한, AI 에이전트가 현재 실행 환경을 정확히 인지하게 되어, 존재하지 않는 기능을 추천하는 오류가 줄어들고 더욱 신뢰할 수 있는 연구 보조가 가능해졌습니다.

2. vv0.52.18/12/2026

   Point release over v0.52.0: the current stable plus 2 applied commit(s), isolated from the changes still soaking on main. Applied: 88ef23153828f545fc75babbad3227789bc84d84, d28a6ce5574f0de9c500b8ffff1a67737c5144c0 ### Patch Changes - Link classification is now uniform across the editor, the audit, and the document graph, so every surface gives the same answer about whether a target exists. - Reference-style links resolve to their definition's destination in the editor: the link chip, hov

3. vv0.51.38/11/2026

   OpenKnowledge v0.51.3 업데이트는 Windows와 Linux 사용자를 위한 플랫폼 최적화에 집중했습니다. 운영체제별로 메뉴 명칭과 파일 관리 방식을 통일하여, 다양한 컴퓨팅 환경에서도 혼선 없이 도구를 사용할 수 있도록 개선되었습니다. 특히 버그 보고 및 삭제 프로세스가 각 OS에 맞춰 정교해져, 다양한 실험 환경에서 도구를 사용하는 연구원님들의 워크플로우를 더욱 매끄럽게 만들어 줍니다.

4. vv0.50.18/10/2026

   이번 업데이트에서는 `main` 브랜치가 아닌 다른 브랜치에서 문서가 로드되지 않던 버그가 해결되어, 다양한 실험 버전을 관리하는 연구원들이 더욱 안정적으로 작업할 수 있어요. 서버 연결 오류 시 구체적인 원인을 로그로 남겨주기 때문에, 데이터 동기화 이슈가 발생했을 때 원인을 추측하는 대신 즉각적인 대응이 가능해졌습니다. 또한, 예상치 못한 크래시 발생 시 오류 보고 기능이 개선되어 연구 프로세스 중 발생하는 기술적 문제를 놓치지 않고 정확하게 파악할 수 있답니다.

5. vv0.49.28/8/2026

   OpenKnowledge v0.49.2 업데이트에서는 Skills editor 내 빈 탭을 클릭할 때 첫 번째 탭으로 강제 이동되던 버그가 수정되었습니다. 이제 여러 개의 빈 탭을 원하는 대로 자유롭게 전환하며 사용할 수 있어, 실험 기술이나 연구 역량을 정리할 때 훨씬 쾌적한 환경을 제공합니다. 탭 전환 오류로 인한 작업 흐름의 끊김 없이, 더욱 매끄럽게 연구 관련 데이터를 관리해 보세요.

6. vv0.49.18/7/2026

   이번 업데이트에서는 에디터가 읽고 있는 도중에 갑자기 다른 파일로 이동하던 버그가 수정되어, 논문이나 실험 프로토콜을 검토할 때 흐름이 끊기지 않고 집중할 수 있어요. 백그라운드에서 에이전트가 작업하더라도 현재 보고 있는 페이지를 안정적으로 유지해주어 연구 흐름을 방해받지 않게 됩니다. 또한, 업데이트 과정의 안정성을 높이고 불필요한 설치 캐시를 정리해 저장 공간을 더욱 효율적으로 관리할 수 있게 되었답니다.

7. vv0.48.108/6/2026

   Point release over v0.48.9: the current stable plus 1 applied commit(s), isolated from the changes still soaking on main. Mode: cherry-pick Applied: 7b280f58663bae0e0fcc25c427fffc2fe509f9fe ### Patch Changes - Follow-the-file no longer opens a blank "create-on-open" tab for a document the agent never actually worked on. A read/search/exec tool call whose newest file location resolves to a doc that does not exist (for example a git branch name or a path echoed from the prompt, like the phantom

8. vv0.48.68/5/2026

   OpenKnowledge v0.48.6 업데이트에서는 파일 사이드바의 폴더 관리 기능이 더욱 직관적으로 개선되었어요. 기존에는 스크롤 시 상단에 고정된 폴더 헤더를 클릭하면 폴더가 접히지 않는 오류가 있었지만, 이제는 클릭 한 번으로 폴더를 접고 해당 위치로 바로 이동할 수 있습니다. 방대한 양의 시퀀싱 데이터나 실험 결과 파일을 폴더별로 관리할 때, 복잡한 디렉토리 구조를 훨씬 빠르고 쾌적하게 탐색할 수 있어 연구 효율을 높여줄 거예요.

9. vv0.47.18/4/2026

   OpenKnowledge v0.47.1에서는 스킬을 프로젝트나 글로벌 범위로 이동할 때 데이터가 불완전하게 복제되던 버그가 해결되었습니다. 기존에는 자동 저장 기능으로 인해 참조 파일이나 스크립트가 누락된 폴더가 생성되는 문제가 있었으나, 이제는 이동이나 삭제 시 파일 구조가 안전하게 유지됩니다. 실험 프로토콜과 연구 스크립트를 체계적으로 관리해야 하는 생명공학 연구원분들께 데이터 무결성을 높여주는 이번 업데이트를 추천합니다. 단, 이미 발생한 깨진 폴더는 직접 삭제해 주셔야 합니다.

10. vv0.46.28/3/2026

    이번 업데이트에서는 다른 프로그램의 크래시 정보가 OpenKnowledge의 오류로 잘못 기록되거나, 외부 프로세스의 메모리가 버그 리포트에 포함될 수 있었던 보안 취약점이 해결되었습니다. 덕분에 민감한 실험 데이터를 다루는 연구원분들의 데이터 보안과 프라이버시가 더욱 강화되었습니다. 또한, 대용량 텍스트나 바이너리 파일을 열 때 앱이 강제 종료되던 버그도 수정되어, 대규모 유전체 데이터 등 큰 용량의 파일을 더욱 안정적으로 확인할 수 있습니다.

11. vv0.45.58/2/2026

    OpenKnowledge v0.45.5 업데이트에서는 파일 사이드바에서 이름을 변경할 때 확장자가 중복으로 붙던 버그가 해결되었습니다. 기존에는 `.md.md`와 같이 파일명이 꼬여 문서가 중복 생성되는 혼선이 있었지만, 이제는 의도한 대로 정확하게 이름이 변경됩니다. 실험 프로토콜이나 연구 노트를 빈번하게 수정하고 관리하는 연구원들에게 파일 관리의 정확성을 높여줄 유용한 패치입니다. 이를 통해 파일 이름 오류로 인한 데이터 혼선을 방지하고 더욱 체계적인 연구 기록 관리가 가능해졌습니다.

12. vv0.45.48/1/2026

    OpenKnowledge v0.45.4 업데이트에서는 플러그인을 활성화할 때 해당 설정 페이지로 즉시 이동할 수 있는 'Open settings' 버튼이 도입되었습니다. 실험 데이터 구조화나 메타데이터 관리를 위해 플러그인을 설정할 때, 복잡한 사이드바를 일일이 뒤질 필요 없이 클릭 한 번으로 바로 세부 설정을 마칠 수 있어 매우 편리합니다. 또한 관련 문서로 연결되는 'Learn more' 링크도 함께 제공되어, 새로운 기능을 연구 워크플로우에 더욱 빠르고 정확하게 적용할 수 있습니다.

13. vv0.45.27/31/2026

    이번 OpenKnowledge v0.45.2 업데이트에서는 다크 모드 사용 시 에이전트 아이콘이 검게 뭉쳐 보이던 시인성 문제를 해결했어요. 이제 다양한 AI 에이전트들의 아이콘이 다크 모드에서도 선명하게 표시되어, 복잡한 데이터 분석이나 문헌 조사 과정에서 에이전트를 훨씬 직관적으로 식별할 수 있습니다. 또한 버그 보고 창의 레이아웃도 개선되어 도구 사용 중 발생하는 불편함을 더욱 쾌적하게 관리할 수 있게 되었답니다.

14. vv0.45.07/30/2026

    시각적 에디터에서 입력한 빈 줄이 이제 사라지지 않고 그대로 유지되어, 실험 프로토콜이나 연구 노트의 문서 구조를 더욱 정확하게 관리할 수 있어요. 또한, 시각적 모드와 마크다운 모드를 전환할 때 보던 위치를 유지해 주며 특정 블록의 소스 코드로 즉시 이동하는 기능이 추가되었습니다. 덕분에 복잡한 마크다운 형식을 사용하는 연구원들이 문서의 흐름을 놓치지 않고, 훨씬 더 매끄럽고 효율적으로 연구 기록을 편집할 수 있게 되었어요.

15. vv0.42.17/29/2026

    이번 업데이트에서는 `$5$`와 같은 수식이나 `%%` 같은 특수 기호를 입력할 때 의도치 않게 서식이 적용되던 문제가 해결되었습니다. 이제 백슬래시(`\`)를 사용해 기호를 이스케이프하면 텍스트가 변형되거나 데이터가 손실되지 않고 입력한 그대로 정확하게 저장됩니다. 실험 프로토콜이나 농도 수치를 기록할 때 서식 오류 걱정 없이 더욱 정밀한 문서 작성이 가능해졌습니다. 또한, `palette` 도구를 통해 현재 사용 가능한 기호와 제어 방법을 바로 확인할 수 있어 문서 관리의 편의성도 높아졌습니다.

16. vv0.41.17/28/2026

    이번 업데이트에서는 모든 AI 호출 인터페이스가 사용자가 설정한 '선호 AI'를 일관되게 따르도록 개선되어, 분석 환경의 예측 가능성이 높아졌습니다. 특히 단축키를 사용할 때 코드가 즉시 실행되지 않고 편집 가능한 상태로 남게 되어, 복잡한 바이오 데이터 처리 스크립트를 더욱 정교하게 수정하고 완성할 수 있습니다. 실수로 코드가 자동 실행되는 위험도 함께 해결되었으니, 대규모 유전체 데이터 분석처럼 정밀한 작업이 필요한 연구원분들께 매우 유용한 업데이트입니다.

17. vv0.41.07/27/2026

    OpenKnowledge v0.41.0에서는 끊어진 링크를 더 스마트하게 관리할 수 있는 기능이 추가되었어요. 이제 잘못된 링크를 발견하면 즉시 새 페이지를 생성할 수 있어, 복잡한 실험 프로토콜이나 연구 기록의 연결성을 놓치지 않고 유지할 수 있습니다. 특히 새롭게 도입된 'Follow' 모드를 사용하면, 수정 권한이 없는 연구원이라도 공유된 연구 데이터나 SOP의 최신 업데이트를 실시간으로 안전하게 동기화할 수 있어요. 이를 통해 실험실 내 공유 지식 베이스를 더욱 정확하고 편리하게 활용해 보세요.

18. vv0.39.47/25/2026

    이번 업데이트에서는 파일이나 폴더의 이름을 변경하거나 삭제할 때 발생하던 데이터 불일치 문제가 해결되어, 실험 데이터 관리의 안정성이 크게 높아졌어요. 이제 대규모 연구 자료를 정리할 때 탭이나 내비게이션이 꼬이지 않고 깔끔하게 유지되어 연구 흐름을 끊김 없이 이어갈 수 있습니다. 또한 `.okignore` 설정이 더욱 정확하게 작동하여, 불필요한 파일은 사이드바에서 숨기고 핵심적인 연구 자산에만 집중할 수 있는 쾌적한 작업 환경을 제공해요.

19. vv0.39.37/24/2026

    OpenKnowledge v0.39.3에서는 여러 서버 인스턴스를 동시에 실행할 때 발생할 수 있는 데이터 간섭 문제를 해결했어요. 이제 각 서버가 독립적으로 문서 상태를 관리하므로, 데이터 병합 오류나 기록 누락과 같은 불안정성을 방지할 수 있습니다. 대규모 실험 데이터를 여러 파이프라인으로 동시에 처리해야 하는 생명공학 연구자분들에게 더욱 정밀하고 신뢰할 수 있는 데이터 관리 환경을 제공할 거예요.

20. vv0.38.27/23/2026

    OpenKnowledge v0.38.2 업데이트에서는 사용자 인터페이스(UI)의 시각적 완성도를 높이는 패치가 진행되었습니다. 린트(Lint) 팝업의 수정 버튼 스타일을 표준화하고, 설정 사이드바의 검색창 디자인을 일관성 있게 개선하여 시각적 혼란을 줄였습니다. 덕분에 복잡한 코드를 다루는 생명공학 연구원들이 더욱 직관적이고 쾌적한 환경에서 도구를 활용할 수 있습니다.

21. vv0.37.17/22/2026

    OpenKnowledge v0.37.1에서는 리스트 안에 제목이나 코드 블록을 붙여넣을 때 서식이 함께 뭉쳐버리던 문제가 해결되었습니다. 이제 실험 프로토콜이나 바이오인포매틱스 코드를 리스트 사이에 붙여넣어도 구조가 깨지지 않고 깔끔하게 분리되어 저장됩니다. 불필요한 빈 줄이나 중복된 리스트 기호도 정리되어, 복잡한 연구 데이터를 체계적으로 기록하고 관리하기 훨씬 편리해졌습니다.

22. vv0.35.37/21/2026

    OpenKnowledge v0.35.3 업데이트에서는 연구자의 작업 흐름을 방해하는 요소들을 줄이는 데 집중했습니다. `/image` 명령어 사용 시 이미지 제안 창이 즉시 나타나지 않도록 개선되어, 실험 데이터나 현미경 사진 등을 컴퓨터에서 바로 업로드하기가 훨씬 편리해졌습니다. 또한, 앱 업데이트 후 발생할 수 있는 서버 버전 불일치 문제를 자동으로 해결해 주므로, 별도의 수동 조작 없이도 끊김 없는 연구 환경을 유지할 수 있습니다.

23. vv0.35.07/20/2026

    OpenKnowledge v0.35.0에서는 AI 프롬프트 입력 용량이 최대 100KB까지 대폭 늘어나, 긴 유전자 서열이나 복잡한 실험 프로토콜도 데이터 잘림 없이 한 번에 처리할 수 있어요. 또한, 코드나 문서의 오류를 AI가 즉시 분석하고 수정해 주는 기능이 강화되어 생명정보학(Bioinformatics) 스크립트 관리 효율이 매우 높아졌습니다. 명령어 팔레트의 기능 확장과 수식 입력 편의성 개선까지 더해져, 방대한 연구 데이터를 다루는 연구원들의 작업 흐름이 더욱 빠르고 정교해질 것으로 기대됩니다.

24. vv0.34.07/17/2026

    OpenKnowledge v0.34.0에서는 외부 링크에 마우스를 올리는 것만으로 미리보기가 제공되어, 관련 논문이나 참고 자료를 훨씬 빠르게 훑어볼 수 있어요. 특히 Mermaid 다이어그램을 시각적으로 직접 편집할 수 있는 기능이 추가되어, 복잡한 생물학적 경로(pathway)나 실험 워크플로우를 코딩 없이도 직관적으로 설계할 수 있습니다. 또한 Git-LFS 관련 오류와 창 관리 기능이 개선되어, 대용량 데이터를 다루는 연구 프로젝트의 작업 안정성도 한층 높아졌습니다.

25. vv0.32.07/16/2026

    OpenKnowledge v0.32.0에서는 앱 내 버그 보고 기능이 강화되어, 연구 중 발생할 수 있는 예기치 못한 오류나 충돌 상황을 더욱 쉽고 안전하게 해결할 수 있습니다. 또한, 외부 서버와 연결된 환경에서도 이미지, PDF, 영상 등 다양한 연구 자산을 데스크톱 창에서 바로 확인할 수 있도록 렌더링 기능이 개선되었습니다. 이를 통해 실험 이미지나 논문 자료를 별도의 번거로운 과정 없이 직관적으로 검토할 수 있어, 데이터 분석 및 문헌 조사 업무의 효율성을 한층 높일 수 있습니다.

26. vv0.30.17/15/2026

    이번 업데이트에서는 CLI를 통해 시맨틱 검색용 임베딩 엔드포인트를 직접 설정할 수 있어, 대규모 생물학적 데이터 분석 파이프라인을 자동화하기 훨씬 편리해졌어요. 또한 설정 화면에서 URL 유효성을 즉시 검증해 주므로, 잘못된 주소 입력으로 인해 문헌이나 데이터 검색 기능이 예기치 않게 실패하는 문제를 방지할 수 있습니다. 자동화된 연구 워크플로우의 안정성을 높이고 정확한 의미 기반 검색을 유지하고 싶은 연구원님들께 유용한 업데이트예요.

27. vv0.30.07/13/2026

    OpenKnowledge v0.30.0에서는 터미널 내 파일 경로와 URL을 클릭 한 번으로 바로 열 수 있는 기능이 추가되어, 방대한 연구 문서와 프로토콜 사이를 훨씬 빠르게 이동할 수 있어요. 또한 새로운 AI 옵션인 Hermes Agent가 도입되어, 연구 데이터를 분석하고 관리할 때 더 다양한 AI 에이전트를 활용할 수 있게 되었답니다. 복잡했던 미리보기 설정도 간소화되어 실험 결과나 데이터를 확인하는 과정이 더욱 직관적이고 편리해졌으니, 연구 워크플로우의 효율을 높이고 싶은 분들께 이번 업데이트를 추천드려요.

28. vv0.29.17/11/2026

    이번 업데이트에서는 LM Studio 지원이 추가되어, 보안이 중요한 실험 데이터나 논문 정보를 외부 유출 걱정 없이 로컬 환경에서 안전하게 검색하고 관리할 수 있어요. Google Antigravity와의 연동을 통해 AI 에이전트 기반의 워크플로우가 더욱 강력해졌으며, 선택한 텍스트를 즉시 AI CLI로 전달하는 단축키 기능도 새롭게 도입되었답니다. 방대한 생명공학 문헌 분석이나 복잡한 데이터 처리를 수행할 때, 더욱 빠르고 안전한 연구 환경을 구축해 보세요.

29. vv0.28.27/9/2026

    OpenKnowledge v0.28.2에서는 Mermaid 다이어그램의 라벨 수정 사항이 실시간으로 반영되어, 복잡한 생물학적 경로(pathway)나 실험 워크플로우를 더욱 직관적으로 시각화할 수 있습니다. 특히 코드 블록에 새롭게 추가된 'Ask AI' 버튼을 통해 실험 데이터나 분석 코드를 AI에게 즉시 질문하고 도움을 받을 수 있어 데이터 처리 효율이 높아졌습니다. 또한, 윈도우 환경의 UI 개선과 온보딩 프로세스 최적화로 연구자가 실험 기록 및 프로젝트 관리에만 온전히 집중할 수 있는 더욱 깔끔한 작업 환경을 제공합니다.

30. vv0.27.07/8/2026

    OpenKnowledge v0.27.0에서는 Pi 코딩 에이전트(pi.dev)를 공식 지원하여, 생물정보학 데이터 분석이나 실험 자동화 스크립트 작성 시 AI 도구의 활용 범위가 더욱 넓어졌습니다. 특히 설정 메뉴에 'AI 도구 및 CLI' 섹션이 신설되어, Claude나 Cursor 같은 다양한 AI 에이전트와 분석 스킬을 클릭 한 번으로 간편하게 관리하고 설치할 수 있습니다. 이를 통해 연구원님은 복잡한 환경 설정 과정 없이도 연구 목적에 최적화된 AI 분석 환경을 더욱 빠르고 체계적으로 구축할 수 있습니다.

31. vv0.25.07/7/2026

    OpenKnowledge v0.25.0에서는 OpenClaw 에디터와의 자동 연동 기능이 추가되어, 별도의 복잡한 설정 없이도 연구 환경을 즉시 구축할 수 있어요. 특히 Mermaid 다이어그램에 확대, 축소, 초기화 컨트롤이 도입되어 복잡한 생물학적 경로(pathway)나 실험 워크플로우를 더욱 정밀하게 시각화하고 분석할 수 있게 되었답니다. 또한, Windows 환경에서 발생하던 서버 연결 오류가 해결되어 윈도우 기반 연구 환경에서도 끊김 없이 안정적으로 도구를 활용할 수 있습니다.

32. vv0.24.07/2/2026

    ## 0.24.0 Stable promotion of beta v0.24.0-beta.10. Aggregated changes since previous stable: ### 0.24.0-beta.0 ### Minor Changes - Invite OK Desktop users to subscribe to product updates from the post-update release-notes card. When the app updates, the "Updated to Version X · Release notes" card in the sidebar footer now also carries a compact "Stay in the loop" subscribe form (reusing the existing form) with a "Follow us on" row for X, GitHub, and Discord — shown only when the user hasn'

33. vv0.23.07/1/2026

    OpenKnowledge v0.23.0에서는 초보 사용자를 위한 온보딩 가이드가 도입되어 연구 프로젝트를 더욱 빠르게 시작할 수 있어요. 특히 파일을 터미널로 드래그하면 경로가 자동으로 입력되는 기능이 개선되어, 실험 이미지나 대용량 데이터 파일을 AI에게 바로 전달하며 분석을 요청하기가 매우 편리해졌습니다. 또한 터미널 내 AI 채팅 기능이 강화되어, 복잡한 바이오 정보학(Bioinformatics) 스크립트 작성과 데이터 분석 워크플로우가 한층 더 매끄러워질 것으로 기대됩니다.

34. vv0.21.06/30/2026

    OpenKnowledge v0.21.0에서는 설정 파일의 형식을 보존하는 기능이 강화되어, 기존에 구축해둔 복잡한 연구 환경 설정을 손상 없이 안전하게 유지할 수 있습니다. 파일 인덱싱 지연 오류가 해결됨에 따라, 새로 작성한 실험 프로토콜이나 연구 노트가 즉시 정확하게 반영되어 데이터 누락이나 링크 오류 걱정 없이 관리할 수 있습니다. 또한, 첨부 파일의 저장 경로를 직접 설정할 수 있는 기능이 추가되어 대량의 실험 이미지나 데이터 파일을 더욱 체계적으로 정리하고 관리하기 편리해졌습니다.

35. vv0.20.06/29/2026

    이번 OpenKnowledge v0.20.0 업데이트에서는 복잡한 생물정보학 프로젝트 관리를 위한 Git 워크트리 인식 오류가 해결되어, 하위 폴더에서도 프로젝트 루트를 정확히 찾아낼 수 있어요. 또한, 동일한 파일이 여러 탭에 중복 생성되던 버그를 수정하여 데이터 분석 시의 혼선을 줄였습니다. 터미널 실행 시 발생하던 명령어 오류도 개선되어, 분석 파이프라인을 구동하는 워크플로우가 더욱 매끄럽고 안정적으로 변했습니다. 숙련된 사용자라면 숨겨진 `ok cowork` 명령어를 활용해 Claude Desktop용 맞춤형 스킬을 더욱 정교하게 구축하며 연구 자동화 효율을 높일 수 있습니다.