> ## 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

> A local folder synced to Gobi and optionally published as a profile.

A vault is a local directory wired to Gobi: its files sync to your webdrive, and a `PUBLISH.md` at the root can be published as the vault's public profile.

<Warning>
  **Experimental.** The webdrive behind vaults is still a trial feature, and it sits outside the Home-and-spaces model that the rest of Gobi runs on. Expect it to change.
</Warning>

## Set up

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

Interactive: select or create the vault for the current directory. Writes `.gobi/settings.yaml` and seeds a `PUBLISH.md` if one is missing.

```sh theme={null}
gobi vault create my-notes --name "My Notes"   # create without anchoring; run init after to anchor
gobi vault list                                # vaults you own
gobi vault status                              # publish state and metadata of the configured vault
gobi vault rename "New Name"                   # local display name only
```

## Sync

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

Syncs local files with Gobi Webdrive. What gets synced is controlled by `.gobi/syncfiles`, a whitelist of patterns, one per line. Sync state lives in `.gobi/sync.db`, managed by the CLI.

## Publish a profile

```sh theme={null}
gobi vault publish      # upload PUBLISH.md to the vault root
gobi vault unpublish    # remove it
```

`PUBLISH.md` is a markdown document with YAML frontmatter; the frontmatter controls the public profile's title and metadata. Publishing triggers post-processing on the server: vault sync and a metadata update.

## Delete

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

Irreversible, and the slug must be passed explicitly. The API rejects deletion while the vault still owns content, so clean up posts, members, and files first.