레퍼런스 - Gobi

최상위 옵션

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

경로	내용	관리 주체
`~/.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`로 발행

gobi update            # 최신 버전으로 업데이트
gobi update --check    # 설치 없이 확인만

2.5.0의 모든 명령을 한 줄씩. 가이드: 스페이스 · Home · 아티팩트 · Vault.

명령	하는 일
`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`

내 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 …`	아티팩트 서브명령
`activities list` / `get <id>` / `transcript <id>`	캡처된 activity, 읽기 전용
`conversations list` / `transcript <id>` / `audio <id>`	캡처된 conversation, 읽기 전용

명령	하는 일
`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>`	아티팩트와 리비전 트리 삭제

실험 기능입니다. 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가 콘텐츠를 갖고 있으면 거부