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

# Gobi CLI

> The programmatic interface to Gobi, built for agents and scripts.

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

<CodeGroup>
  ```sh Homebrew theme={null}
  brew tap gobi-ai/tap
  brew install gobi
  ```

  ```sh npm theme={null}
  npm install -g @gobi-ai/cli
  ```
</CodeGroup>

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

## Sign in

```sh theme={null}
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`.

```sh theme={null}
gobi auth status   # who am I
gobi auth logout   # clear stored credentials
```

## Quick start

```sh theme={null}
# 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](/cli/spaces)            |
| `gobi personal`          | The same posting surface in your Home, plus everything you captured. [Details](/cli/personal)    |
| `gobi personal artifact` | Versioned creations, held in your Home until you attach one to a post. [Details](/cli/artifacts) |
| `gobi vault`             | A local folder synced to Gobi's webdrive. Experimental. [Details](/cli/vault)                    |

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

<Note>
  Documented against CLI `2.3.0`. Creating a space happens in the app.
</Note>