내 컴퓨터의 Obsidian과 연결하기

원리 — 왜 이게 되나요

지식저장소는 평범한 GitHub 저장소입니다. 내 컴퓨터로 복제(clone)하면 노트 폴더가 그대로 생기고, Obsidian은 그 폴더를 여는 앱이에요. 이 과정은 전부 내 컴퓨터와 내 GitHub 계정 사이에서 일어납니다 — KEZ 서버는 이 연결에 관여하지 않고, 어떤 정보도 거치지 않아요.

1. GitHub Desktop 설치 (1회)

desktop.github.com에서 GitHub Desktop을 내려받아 설치하고, ‘Sign in to GitHub.com’으로 브라우저 로그인 한 번만 해주세요. 이걸로 인증은 끝이에요 — 토큰 발급도, 비밀번호 입력도, 터미널도 없습니다.

2. 저장소 내려받기

GitHub Desktop에서 File → Clone Repository를 열면 내 저장소 목록에 secondbrain-vault가 보여요. 선택하고 저장할 위치를 정한 뒤 Clone을 누르면 노트 폴더가 컴퓨터에 생깁니다.

3. Obsidian으로 열기

Obsidian을 실행하고 ‘폴더를 보관함으로 열기(Open folder as vault)’로 방금 받은 secondbrain-vault 폴더를 선택하세요. 노트 전체가 그대로 보입니다.

4. 자동 동기화 켜기 (3분 간격)

설정 → 커뮤니티 플러그인에서 Git 플러그인을 설치·활성화하고:

• Vault backup interval: 3 (3분마다 자동 커밋·푸시)
• Auto pull interval: 3 (Claude가 쓴 노트를 3분마다 자동으로 내려받기)
• Pull updates on startup: 켜기

이후에는 손댈 게 없어요. 로컬에서 고친 노트는 자동으로 올라가고, 대화로 만든 노트는 자동으로 내려옵니다.

Git 플러그인이 GitHub Desktop이 남긴 로그인 정보를 그대로 사용하므로 별도 인증은 필요 없어요. (macOS에서 git 설치 안내 창이 뜨면 ‘설치’만 눌러주세요.)

5. 주의할 점

같은 노트를 양쪽에서 동시에 수정하면 드물게 충돌이 생길 수 있어요. 플러그인이 알려주며, 대부분 자동으로 병합됩니다. 문의: kezilac.works@gmail.com