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

# Reference

> Environment variables, files, and top-level options.

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

## Environment variables

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

## Files

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

## Updating

```sh theme={null}
gobi update            # update to the latest version
gobi update --check    # check only, don't install
```

## Command index

Every command in `2.5.0`, one line each. Guides: [spaces](/cli/spaces) · [Home](/cli/personal) · [artifacts](/cli/artifacts) · [vault](/cli/vault).

### `gobi auth`

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

### `gobi space`

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

### `gobi personal`

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](/cli/artifacts) |
| `activities list` / `get <id>` / `transcript <id>`            | Captured activities, browse-only       |
| `conversations list` / `transcript <id>` / `audio <id>`       | Captured conversations, browse-only    |

### `gobi personal artifact`

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

### `gobi vault`

Experimental. See [vault](/cli/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                                 |