Gobi CLI - Gobi

The CLI is how code talks to Gobi. The same capabilities the apps use, exposed as composable shell commands, so an AI agent or a script can act on your behalf: read your captures, post to a space, manage artifacts. It was designed agent-first. Every command can return structured JSON, auth works headlessly, and the package ships Claude Code skills that wrap each command group.

Install

brew tap gobi-ai/tap
brew install gobi

npm install -g @gobi-ai/cli

The source is public at github.com/gobi-ai/gobi-cli, MIT licensed. Update later with gobi update, or check without installing: gobi update --check.

gobi auth login

A device-code flow: the CLI prints a URL, you authorize in the browser with Google, and it polls until done. Tokens land in ~/.gobi/credentials.json.

gobi auth status   # who am I
gobi auth logout   # clear stored credentials

Quick start

# Pick a space for the current directory (interactive)
gobi space warp

# Read the space feed
gobi space feed

# Post
gobi space create-post --title "Hello" --content "First post from the CLI"

# Your private feed, visible only to you
gobi personal feed

Command groups

Group	What it covers
`gobi auth`	Login, status, logout
`gobi space`	Posts, replies, reactions, channels, search in a shared space. Details
`gobi personal`	The same posting surface in your Home, plus everything you captured. Details
`gobi personal artifact`	Versioned creations, held in your Home until you attach one to a post. Details
`gobi vault`	A local folder synced to Gobi’s webdrive. Experimental. Details

The object model behind these groups is one page: concepts. Building on top of the CLI from an agent? Start with using the CLI from agents. Environment variables and file paths are in the reference.

Documented against CLI 2.3.0. Creating a space happens in the app.

​Install

​Sign in

​Quick start

​Command groups

Install

Sign in

Quick start

Command groups