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

# 레퍼런스

> 환경 변수, 파일, 최상위 옵션.

## 최상위 옵션

| 플래그             | 효과                                        |
| --------------- | ----------------------------------------- |
| `--json`        | 사람용 출력 대신 구조화된 봉투. 최상위 플래그라 서브커맨드 앞에 옵니다. |
| `-V, --version` | CLI 버전 출력                                 |

## 환경 변수

| 변수                       | 기본값                             | 설명                      |
| ------------------------ | ------------------------------- | ----------------------- |
| `GOBI_BASE_URL`          | `https://api.joingobi.com`      | API 서버                  |
| `GOBI_WEBDRIVE_BASE_URL` | `https://webdrive.joingobi.com` | 파일 저장소                  |
| `GOBI_WEB_BASE_URL`      | `https://gobispace.com`         | 공유 링크를 만들 때 쓰는 공개 웹 URL |

## 파일

| 경로                         | 내용                                   | 관리 주체                                |
| -------------------------- | ------------------------------------ | ------------------------------------ |
| `~/.gobi/credentials.json` | 인증 토큰                                | `gobi auth login` / `logout`         |
| `.gobi/settings.yaml`      | 프로젝트별 vault·스페이스 선택                  | `gobi vault init`, `gobi space warp` |
| `.gobi/syncfiles`          | `gobi vault sync` 화이트리스트, 한 줄에 패턴 하나 | 사용자                                  |
| `.gobi/sync.db`            | 로컬 동기화 상태 (커서, 해시 캐시)                | CLI                                  |
| `PUBLISH.md`               | YAML frontmatter가 붙은 vault 프로필 문서    | 사용자, `gobi vault publish`로 발행        |

## 업데이트

```sh theme={null}
gobi update            # 최신 버전으로 업데이트
gobi update --check    # 설치 없이 확인만
```

## 명령 인덱스

`2.5.0`의 모든 명령을 한 줄씩. 가이드: [스페이스](/ko/cli/spaces) · [Home](/ko/cli/personal) · [아티팩트](/ko/cli/artifacts) · [Vault](/ko/cli/vault).

### `gobi auth`

| 명령       | 하는 일                     |
| -------- | ------------------------ |
| `login`  | Google OAuth 디바이스 코드 로그인 |
| `status` | 지금 누구로 로그인돼 있는지          |
| `logout` | 저장된 자격 증명 삭제             |

### `gobi space`

| 명령                                                                          | 하는 일                                                                    |
| --------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| `list`                                                                      | 내가 속한 스페이스                                                              |
| `get [spaceSlug]`                                                           | 스페이스 상세                                                                 |
| `warp [spaceSlug]`                                                          | 이 디렉토리에서 쓸 스페이스 선택                                                      |
| `feed`                                                                      | 통합 피드, 최신순. `--channel <id>`로 좁히기                                       |
| `list-posts`                                                                | 루트 포스트만                                                                 |
| `get-post <postId>`                                                         | 포스트와 조상·답글                                                              |
| `create-post` / `edit-post <postId>` / `delete-post <postId>`               | 쓰고 고치고 지우기                                                              |
| `create-reply <postId>` / `edit-reply <replyId>` / `delete-reply <replyId>` | 답글도 동일                                                                  |
| `react <id> <emoji>` / `unreact <id> <emoji>`                               | 반응, 양방향 멱등                                                              |
| `search-posts <query>`                                                      | 키워드 + `from:` · `topic:` 연산자                                            |
| `list-topics` / `list-topic-posts <topicSlug>`                              | 토픽으로 훑기                                                                 |
| `list-channels` / `get-channel <id>` / `list-channel-members <id>`          | 채널                                                                      |
| `list-dms`                                                                  | 이 스페이스의 내 DM 대화 목록, 최근 순                                                |
| `open-dm`                                                                   | 대화를 열거나 만들고 id를 출력. `--user` 반복 가능, `--agent space\|personal`로 에이전트와 대화 |
| `dm-messages <dmId>`                                                        | 대화 내용 읽기, 최신 순                                                          |
| `send-dm <dmId>`                                                            | 메시지 보내기. 사람을 부르려면 `--rich-text`, 파일은 `--attach`                         |

### `gobi personal`

내 Home입니다. 포스팅 명령은 `gobi space`에서 채널·토픽을 뺀 것과 같고, 캡처 그룹은 여기에만 있습니다.

| 명령                                                            | 하는 일                           |
| ------------------------------------------------------------- | ------------------------------ |
| `feed` / `list-posts` / `get-post <id>`                       | 나만 보는 피드                       |
| `create-post` / `edit-post <id>` / `delete-post <id>`         | 쓰고 고치고 지우기                     |
| `create-reply <id>` / `edit-reply <id>` / `delete-reply <id>` | 답글은 비공개 범위를 물려받음               |
| `react <id> <emoji>` / `unreact <id> <emoji>`                 | 반응                             |
| `search-posts <query>`                                        | 스페이스와 같은 연산자                   |
| `artifact …`                                                  | [아티팩트 서브명령](/ko/cli/artifacts) |
| `activities list` / `get <id>` / `transcript <id>`            | 캡처된 activity, 읽기 전용            |
| `conversations list` / `transcript <id>` / `audio <id>`       | 캡처된 conversation, 읽기 전용        |

### `gobi personal artifact`

| 명령                               | 하는 일                                       |
| -------------------------------- | ------------------------------------------ |
| `create`                         | 파일·stdin·인라인으로 새 아티팩트. `--post-id`로 바로 붙이기 |
| `list` / `get <id>`              | 내 아티팩트 훑기. `--kind`로 거르기                   |
| `revise <id>`                    | 리비전 기록. `--from <revId>`로 분기               |
| `revert <id> --revision <revId>` | 이전 리비전을 새 리비전으로 복원                         |
| `history <id>`                   | 전체 리비전 트리, owner 전용                        |
| `download <id>`                  | 현재 리비전 받기. `--revision <revId>`로 특정 리비전    |
| `delete <id>`                    | 아티팩트와 리비전 트리 삭제                            |

### `gobi vault`

실험 기능입니다. [Vault](/ko/cli/vault) 문서를 보세요.

| 명령                      | 하는 일                                                           |
| ----------------------- | -------------------------------------------------------------- |
| `init`                  | 이 디렉토리의 vault 선택·생성. `.gobi/settings.yaml` 작성, `PUBLISH.md` 생성 |
| `create <slug>`         | 현재 디렉토리에 연결하지 않고 vault만 생성                                     |
| `list` / `status`       | 내 vault 목록, 설정된 vault의 발행 상태                                   |
| `rename <newName>`      | 로컬 표시 이름만 변경                                                   |
| `sync`                  | `.gobi/syncfiles` 기준으로 파일 동기화                                  |
| `publish` / `unpublish` | `PUBLISH.md`를 vault 루트에 올리거나 내리기                               |
| `delete <slug>`         | 되돌릴 수 없음. vault가 콘텐츠를 갖고 있으면 거부                                |