Vault - Gobi

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.

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.

Set up

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.

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

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

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

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.

​Set up

​Sync

​Publish a profile

​Delete

Set up

Sync

Publish a profile

Delete