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

> 에이전트와 스크립트를 위한 Gobi 프로그래밍 인터페이스.

CLI는 코드가 Gobi와 대화하는 통로입니다. 앱이 쓰는 것과 같은 기능이 셸 명령으로 열려 있어서, AI 에이전트나 스크립트가 내 캡처를 읽고, 스페이스에 올리고, 아티팩트를 관리할 수 있어요.

설계 자체가 에이전트 우선입니다. 모든 명령이 구조화된 JSON을 돌려줄 수 있고, 인증은 headless로 돌아가고, 명령 그룹을 감싼 Claude Code 스킬이 패키지에 들어 있습니다.

## 설치

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

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

소스는 [github.com/gobi-ai/gobi-cli](https://github.com/gobi-ai/gobi-cli)에 공개돼 있고 MIT 라이선스입니다. 업데이트는 `gobi update`로 하고, 설치 없이 확인만 하려면 `gobi update --check`를 씁니다.

## 로그인

```sh theme={null}
gobi auth login
```

디바이스 코드 방식입니다. CLI가 URL을 출력하면 브라우저에서 Google로 승인하고, CLI는 완료될 때까지 기다립니다. 토큰은 `~/.gobi/credentials.json`에 저장돼요.

```sh theme={null}
gobi auth status   # 지금 누구로 로그인돼 있는지
gobi auth logout   # 저장된 인증 정보 삭제
```

## 빠른 시작

```sh theme={null}
# 현재 디렉토리에서 쓸 스페이스 고르기 (인터랙티브)
gobi space warp

# 스페이스 피드 읽기
gobi space feed

# 포스트 올리기
gobi space create-post --title "Hello" --content "CLI에서 보낸 첫 포스트"

# 나만 보는 개인 피드
gobi personal feed
```

## 명령 그룹

| 그룹                       | 하는 일                                                           |
| ------------------------ | -------------------------------------------------------------- |
| `gobi auth`              | 로그인, 상태 확인, 로그아웃                                               |
| `gobi space`             | 공유 스페이스의 포스트, 답글, 반응, 채널, 검색. [자세히](/ko/cli/spaces)            |
| `gobi personal`          | 같은 포스팅 기능을 내 Home에서. 캡처한 것도 전부 여기. [자세히](/ko/cli/personal)     |
| `gobi personal artifact` | 버전 관리되는 창작물. 포스트에 붙이기 전까지 Home에 있습니다. [자세히](/ko/cli/artifacts) |
| `gobi vault`             | Gobi 웹드라이브와 동기화되는 로컬 폴더. 실험 기능입니다. [자세히](/ko/cli/vault)        |

이 그룹들 뒤의 오브젝트 모델은 [개념](/ko/cli/concepts) 한 페이지에 있습니다. 에이전트 위에서 CLI를 쓸 거라면 [에이전트에서 쓰기](/ko/cli/agents)부터 보세요. 환경 변수와 파일 경로는 [레퍼런스](/ko/cli/reference)에 있습니다.

<Note>
  CLI `2.3.0` 기준으로 작성됐습니다. 스페이스 생성은 앱에서 합니다.
</Note>