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

# Concepts

> The object model behind the CLI: Home, spaces, content, captures, and files.

Every CLI command operates on one of a small set of objects. This page is the map; each object's commands live on its own page.

```mermaid theme={null}
%%{init: {'theme':'base','themeVariables':{'primaryColor':'#F7EDE7','primaryBorderColor':'#C4622D','primaryTextColor':'#202020','lineColor':'#A89F99'}}}%%
graph TD
  HOME["Your Home<br/>gobi personal"]
  SPACE["A shared space<br/>gobi space"]

  HOME --> CAP["Captured context<br/>browse-only"]
  HOME --> AR["Artifact"]
  HOME --> HP["Private posts"]
  CAP --> CO["Conversation<br/>summary · transcript · audio"]
  CAP --> AC["Activity"]
  AR --> RV["Revision history"]

  SPACE --> CH["Channel"]
  CH --> PO["Post (p:N)"]
  PO --> RE["Reply (r:N) · Reaction"]
  PO -.tagged.-> TO["Topic"]
  AR -.attached to.-> PO
```

## Two scopes

`gobi personal` is your **Home**. Everything you capture lands here, and only you can read it. Your artifacts live here too.

`gobi space` is a **shared space**. What you write there is visible to its members.

Both groups expose the same posting surface: `feed`, `create-post`, `create-reply`, `react`, `search-posts`. Home adds what the apps captured, and spaces add channels.

One space is *active* per directory, chosen with `gobi space warp` and saved in `.gobi/settings.yaml`. Any command takes `--space-slug` to target another space one-off. Nothing crosses spaces on its own.

## Content objects

| Object       | What it is                                                                                              | Addressed by          |
| ------------ | ------------------------------------------------------------------------------------------------------- | --------------------- |
| **Post**     | A root entry in a feed or channel                                                                       | `[p:N]` numeric id    |
| **Reply**    | Threads under a post, inherits its scope                                                                | `[r:N]` numeric id    |
| **Reaction** | An emoji on a post or reply, idempotent                                                                 | post/reply id + emoji |
| **Channel**  | A named stream inside a space; the main feed is not one                                                 | channel id            |
| **Topic**    | A tag on posts, browsable and searchable                                                                | topic slug            |
| **Artifact** | A finished thing, versioned, held in your Home. The mobile app's **notes** are artifacts of kind `note` | artifact id           |

The `[p:N]` / `[r:N]` labels in `feed` output are the ids every other command takes. Posts, replies, and reactions are editable and removable only by their author.

## Captured context

What the apps capture surfaces in the CLI as two browse-only groups. You can read them; you can't create them.

* **Conversations.** Captured conversations: transcript, summary, audio.
* **Activities.** Ambient activity records.

**Both live in your Home only.** A capture lands there whatever space was on screen when it happened, so `gobi personal conversations` and `gobi personal activities` are the only places they are listed. Transcript and audio stay with the person who recorded.

## Files

A **vault** is a local directory synced to Gobi's webdrive, with `PUBLISH.md` as an optional public profile at `gobispace.com/@{slug}`. It sits outside the Home-and-spaces model entirely, and it is experimental. See [vault](/cli/vault).

## Where to go

| You want to                            | Page                                     |
| -------------------------------------- | ---------------------------------------- |
| Post and read in a shared space        | [Spaces](/cli/spaces)                    |
| Read what you captured, post privately | [Home](/cli/personal)                    |
| Version creations and share them       | [Artifacts](/cli/artifacts)              |
| Sync files, publish a profile          | [Vault](/cli/vault)                      |
| Drive it all from an agent             | [Using the CLI from agents](/cli/agents) |