> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gobihq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vault

> Gobi와 동기화되고, 프로필로 발행할 수 있는 로컬 폴더.

Vault는 Gobi에 연결된 로컬 디렉토리입니다. 파일이 webdrive로 동기화되고, 루트의 `PUBLISH.md`를 발행하면 vault의 공개 프로필이 됩니다.

<Warning>
  **실험 기능.** vault 뒤의 webdrive는 아직 시험 단계이고, Gobi의 나머지가 돌아가는 Home·스페이스 모델 바깥에 있습니다. 바뀔 수 있다고 보세요.
</Warning>

## 설정

```sh theme={null}
gobi vault init
```

인터랙티브 명령이에요. 현재 디렉토리에서 쓸 vault를 고르거나 새로 만듭니다. `.gobi/settings.yaml`을 쓰고, `PUBLISH.md`가 없으면 만들어줘요.

```sh theme={null}
gobi vault create my-notes --name "My Notes"   # 만들기만. 연결하려면 이후 init
gobi vault list                                # 내가 소유한 vault들
gobi vault status                              # 설정된 vault의 발행 상태와 메타데이터
gobi vault rename "New Name"                   # 로컬 표시 이름만 바꿈
```

## 동기화

```sh theme={null}
gobi vault sync
```

로컬 파일을 Gobi Webdrive와 동기화합니다. 무엇을 동기화할지는 `.gobi/syncfiles`가 정해요. 한 줄에 패턴 하나인 화이트리스트입니다. 동기화 상태는 `.gobi/sync.db`에 있고 CLI가 관리합니다.

## 프로필 발행

```sh theme={null}
gobi vault publish      # PUBLISH.md를 vault 루트에 업로드
gobi vault unpublish    # 내리기
```

`PUBLISH.md`는 YAML frontmatter가 붙은 마크다운 문서고, frontmatter가 공개 프로필의 제목과 메타데이터를 정합니다. 발행하면 서버에서 vault 동기화와 메타데이터 갱신이 이어서 돌아가요.

## 삭제

```sh theme={null}
gobi vault delete <slug>
```

되돌릴 수 없고, slug를 명시적으로 넘겨야 합니다. vault에 콘텐츠가 남아 있으면 API가 거부하니 포스트, 멤버, 파일을 먼저 정리하세요.