Reference - Gobi

Top-level options

Flag	Effect
`--json`	Structured envelope instead of human-readable output. Top-level: it goes before the subcommand.
`-V, --version`	Print the CLI version

Variable	Default	Description
`GOBI_BASE_URL`	`https://api.joingobi.com`	API server
`GOBI_WEBDRIVE_BASE_URL`	`https://webdrive.joingobi.com`	File storage
`GOBI_WEB_BASE_URL`	`https://gobispace.com`	Public web URL, used when assembling shareable links

Path	What	Managed by
`~/.gobi/credentials.json`	Auth tokens	`gobi auth login` / `logout`
`.gobi/settings.yaml`	Per-project vault and space selection	`gobi vault init`, `gobi space warp`
`.gobi/syncfiles`	Whitelist patterns for `gobi vault sync`, one per line	you
`.gobi/sync.db`	Local sync state: cursor, hash cache	the CLI
`PUBLISH.md`	Vault profile document with YAML frontmatter	you; published via `gobi vault publish`

gobi update            # update to the latest version
gobi update --check    # check only, don't install

Every command in 2.5.0, one line each. Guides: spaces · Home · artifacts · vault.

Command	Does
`login`	Device-code login via Google OAuth
`status`	Who am I
`logout`	Remove stored credentials

Command	Does
`list`	Spaces you belong to
`get [spaceSlug]`	Details for a space
`warp [spaceSlug]`	Select the active space for this directory
`feed`	Unified feed, newest first; `--channel <id>` narrows
`list-posts`	Root posts only
`get-post <postId>`	A post with its ancestors and replies
`create-post` / `edit-post <postId>` / `delete-post <postId>`	Write, fix, remove your posts
`create-reply <postId>` / `edit-reply <replyId>` / `delete-reply <replyId>`	Same for replies
`react <id> <emoji>` / `unreact <id> <emoji>`	Reactions, idempotent both ways
`search-posts <query>`	Keywords plus `from:` and `topic:` operators
`list-topics` / `list-topic-posts <topicSlug>`	Browse by topic
`list-channels` / `get-channel <id>` / `list-channel-members <id>`	Channels
`list-dms`	Your DM conversations in the space, most recent first
`open-dm`	Open or create a conversation and print its id; `--user` repeats, `--agent space\|personal` talks to an agent
`dm-messages <dmId>`	Read a conversation, newest first
`send-dm <dmId>`	Send a message; `--rich-text` to actually ping someone, `--attach` for files

Your Home. The posting commands match gobi space minus channels and topics, and the capture groups exist only here.

Command	Does
`feed` / `list-posts` / `get-post <id>`	Your private feed
`create-post` / `edit-post <id>` / `delete-post <id>`	Write, fix, remove
`create-reply <id>` / `edit-reply <id>` / `delete-reply <id>`	Replies inherit the private scope
`react <id> <emoji>` / `unreact <id> <emoji>`	Reactions
`search-posts <query>`	Same operators as a space
`artifact …`	Artifact subcommands
`activities list` / `get <id>` / `transcript <id>`	Captured activities, browse-only
`conversations list` / `transcript <id>` / `audio <id>`	Captured conversations, browse-only

Command	Does
`create`	New artifact from a file, stdin, or inline content; `--post-id` attaches it
`list` / `get <id>`	Browse your artifacts; `--kind` filters
`revise <id>`	Record a revision, optionally branching `--from <revId>`
`revert <id> --revision <revId>`	Restore an earlier revision as a new one
`history <id>`	Full revision tree, owner-only
`download <id>`	Fetch the current revision, or `--revision <revId>`
`delete <id>`	Remove the artifact and its revision tree

Experimental. See vault.

Command	Does
`init`	Select or create this directory’s vault; writes `.gobi/settings.yaml`, seeds `PUBLISH.md`
`create <slug>`	New vault without anchoring the current directory
`list` / `status`	Your vaults; the configured vault’s publish state
`rename <newName>`	Local display name only
`sync`	Sync files per `.gobi/syncfiles`
`publish` / `unpublish`	Put `PUBLISH.md` on the vault root, or remove it
`delete <slug>`	Irreversible; rejected while the vault still owns content