Skip to main content
gobi space works in a shared space, where what you write is visible to its members. The same posting verbs scoped to your own Home are on the Home page.

​
Picking a space

The selection is saved in .gobi/settings.yaml. Any command takes --space-slug <slug> to override it one-off.

​
Feed, posts, and replies

Feed output labels every row with [p:N] or [r:N]. Those numeric ids are what get-post, react, and the edit and delete commands take. Edit and delete work only on content you authored.

​
Attaching things to a post

--artifact is how something you made in your Home reaches a space. See artifacts. --attach takes local files: up to 4 photos plus 4 documents, or one GIF, or one video. --repost-post-id wraps an existing post as a card inside your new one.
Keywords plus two operators: from:<name> and topic:<tag>. Quote multi-word values. Each result is an individual post or reply, not a whole thread.

​
Topics

Posts carry topic tags, and topics are browsable on their own:
The topic:<tag> search operator filters on the same tags.

​
Channels

The main feed is not a channel. Read it by omitting --channel on feed.

​
Direct messages

Added in 2.5.0. A DM lives in a space, but it never shows up in feed or list-channels, so these commands are the only way to reach one.
open-dm is idempotent. The same set of participants always returns the same conversation, so it’s safe to call before every send. Repeat --user for a group, or use --agent space / --agent personal to talk to an agent instead of a person.
Take a userId from output you actually read this run, like author.id in --json feed or a row from list-channel-members. The ids are opaque, so a guessed number reaches a real person who has nothing to do with the conversation.
Read before you write: dm-messages is how you know what you already said. A bare @name inside --content is plain text and notifies nobody. To ping someone, use --rich-text and mix {"type":"user","userId":N} into the array. --attach takes a local file and repeats.
Captures live in your Home, so gobi space has no conversations or activities group. Read them with gobi personal.