Guide & FAQ for Feb Cohort

Gobi Desktop WEBDRIVE

WEBDRIVE 기능은 베타 기능이므로 중요한 파일 혹은 민감한 내용은 꼭 백업 부탁드리고 1볼트 1기기 부탁드립니다.

자동 싱크 (기본 동작)

syncfiles에 포함된 파일 폴더가 변경, 삭제, 추가되었을 때 자동으로 3초 후 클라우드 싱크되며, 3초 내에 업데이트가 일어나면 다시 3초 카운트가 시작됩니다.
- syncfiles 파일 자체의 변경도 같은 방식으로 sync됩니다.
Vault root의 BRAIN.md가 업데이트 될 경우, 그 안의 frontmatter에 있는 내용들이 DB에 입력되며 https://app.joingobi.com/discover 페이지에 listing되게 됩니다.
- 필수 항목
  - title: 브레인 이름
  - description: 브레인 설명
- 선택 항목
  - tags: 태그 리스트
  - thumbnail: 프로필 이미지, wiki-link 스타일 파일 링크
  - prompt: 시스템 프롬프트, wiki-link 스타일 파일 링크
- 예시

---
title: My Second Brain
tags:
- tag1
- tag2
description: TBA
thumbnail: "[[BRAIN.jpg]]"
prompt: "[[BRAIN_PROMPT.md]]"
---

싱크 관리

Contents 탭의 파일 목록에서 파란색으로 나오는 파일 이름들은 Cloud와 싱크되어있는 파일들입니다.
컨텐츠 탭 하단에 Sync에 대한 상태가 나오고, Sync to cloud와 Select files 두 버튼을 통해서 manual sync와 syncfiles의 파일 목록을 UI를 통해서 조정할수 있습니다.
기존의 WEBDAV 싱크 UI가 있었던 자리에 생긴 Refresh버튼은 싱크와 관련은 없고 혹시 Filetree에 나오지 않는 파일들이 있다면 refresh하는 기능입니다.

유의 사항

내가 만든 볼트는 모두 https://app.joingobi.com/vaults 이곳에 리스트 됩니다.
BRAIN.md에 Title과 description을 입력하지 않으면 메인 페이지에서는 제외됩니다.
syncfiles에 아무런 entry가 없을 경우, sync가 풀리고 cloud의 vault 자체가 삭제됩니다.
local_delete (멀티 디바이스에서 삭제된 파일을 로컬에서도 삭제하는 기능)은 임시로 disable 해놓았습니다.

Gobi Desktop 3.0

GD이전 버전에 대한 정보는 2026-01-04 AI4PKM W1 온보딩 시나리오를 참고하시고, 여기는

2.x 대비 주요 변화

구글 로그인 기반 사용자 인증
구글 클라우드 기반 자체 음성 에이전트 제공
- 사용자가 자신의 클로드 코드 사용 가능
구글 워크스페이스 연동 제공
브레인 커뮤니티에 파일 공유 기능

커뮤니티 파일 공유 관련 유의사항

커뮤니티 파일 공유는 베타 서비스입니다.
- 중요한 정보는 백업을 받아주세요
각 볼트는 하나의 기기에서만 Gobi Desktop에 올려주세요
- 파일 동기화에 문제가 발생할 수 있습니다
현재 공유중인 파일 목록은 .gobi/syncfiles에서 확인하실 수 있습니다
- 특정 폴더를 선택하시면 해당 폴더에 포함된 파일 및 폴더가 모두 업로드됩니다.
  - 향후에 해당 폴더에 추가되는 파일도 업로드됩니다.
- 개인 정보를 실수로 공유하지 않도록 유의해주세요

Brain Community

커뮤니티 개요

브레인 커뮤니티는 자신이 커뮤니티에 공유한 파일을 바탕으로 자신의 온라인 브레인^[1]을 만들고, 이를 바탕으로 다른 사용자와 소통할 수 있는 공간입니다.
- 커뮤니티는 구글 로그인을 인증을 거친 사용자에게만 공개됩니다.
각 브레인은 옵시디언 볼트에 대응되며, 개별 사용자는 여러 브레인을 만들고 업데이트할 수 있습니다.
- 예: Work Brain / Hobby Brain
기본적으로 아래 파일이 프로필 / 이미지 / (대화) 프롬프트를 구성하며, 추가적으로 파일을 업로드하실 수 있습니다.
- BRAIN.md / BRAIN.jpg / BRAIN_PROMPT.md

BRAIN.md

브레인 커뮤니티에 사용될 본인의 프로필을 정의하는 파일이며, 온보딩 과정에서 사용자에게 맞는 내용으로 채워집니다. (아래 기본값)
https://github.com/jykim/ai4pkm-vault/blob/main/BRAIN.md?plain=1

Frontmatter

Brain Community에 적용되는 BRAIN.md의 Frontmatter 규칙은 다음과 같습니다.

---
title: My Second Brain
tags:
description: TBA
thumbnail: "[[BRAIN.jpg]]"
prompt: "[[BRAIN_PROMPT.md]]"
---

브레인 방문자와의 대화를 뒷받침하는 내용과 관련 문서 링크를 추가하시면 됩니다.
BRAIN.md에 직접 링크되지 않은 공유 파일도 답변 생성에 사용될 수 있습니다.

BRAIN_PROMPT.md

브레인 방문자와의 대화에 적용되는 프롬프트로, 이 파일이 없으면 질문했을때 본인이 AI Agent라고 답변합니다.
(신규 Vault에는 아래 BRAIN_PROMPT.md가 기본값으로 적용)
https://github.com/jykim/ai4pkm-vault/blob/main/BRAIN_PROMPT.md

지식 기반의 온라인 페르소나라고 생각하시면 됩니다. ↩︎