아티팩트

아티팩트는 Gobi가 캡처한 것으로 만들어낸 완성물 하나입니다. 미팅 요약이나 리포트, 이미지가 여기 해당해요. 플랫폼이 창작물을 담아두는 그릇이고, 모바일 앱의 노트가 그 종류 중 하나예요. 소유자는 항상 사람이고, 아티팩트는 내 Home에 있습니다. 스코프는 gobi personal artifact … 하나뿐이에요. 포스트에 붙이기 전까지는 나만 봅니다.

아티팩트가 담는 것

콘텐츠와 리비전 기록. 그게 전부입니다. 아티팩트는 누군가에게 건네는 스냅샷이라 저 혼자 변하지 않아요. 올라가는 카운터도, 읽는 사람이 고치는 항목도 없습니다. 누가 새 리비전을 남기지 않는 한 그대로예요. 계속 움직여야 하는 건 스페이스에 포스트로 남습니다. 이 경계 덕분에 아티팩트를 안심하고 보낼 수 있습니다. 받는 사람이 여는 건 내가 건넨 그대로예요.

종류

종류	만드는 주체	본문
`note`	모바일 앱이 캡처에서, 또는 사람이 직접	YAML frontmatter가 붙은 마크다운
`markdown`	사람 또는 에이전트	마크다운
`image` · `gif` · `video`	사람 또는 에이전트	업로드한 파일

artifact create --kind는 이 전부를 받습니다. image, video, gif, markdown, note.

노트도 아티팩트입니다

모바일 앱에서 대화를 캡처하면 kind: "note"인 아티팩트가 생깁니다. 앱에서는 노트라고 부르고, API에서는 아티팩트로 다룹니다. 이름이 둘인 건 보는 층이 달라서고, 물건은 하나입니다. 노트의 frontmatter에는 앱이 캡처에 대해 알고 있던 것이 담깁니다.

---
title: Coffee with Dana from Cintra
activity_id: 412
category: sales
source: mobile
start_time: 2026-07-01T11:48:00.485Z
end_time: 2026-07-01T13:12:18.874Z
duration: 84 min 18 sec
attendees:
  - Dana Lee
  - Ada Nicodemou
---

## Summary
…

예시 데이터입니다. source가 무엇이 만들었는지, activity_id가 어느 캡처에서 왔는지 알려줍니다.

만들기

# 마크다운: 파일, stdin, 인라인 어느 쪽이든
gobi personal artifact create --kind markdown --file notes.md
echo "# Draft" | gobi personal artifact create --kind markdown --content -

# 미디어 종류는 파일 업로드
gobi personal artifact create --kind image --file chart.png

# 만들면서 포스트에 붙이기
gobi personal artifact create --kind markdown --file summary.md --post-id 1234

--title로 표시 제목을 정합니다. 마크다운 본문의 [[wikilink]] 해석 기준은 --vault-slug로 잡고, --auto-attachments를 주면 링크된 파일을 만들기 전에 웹드라이브로 올립니다.

고치기

gobi personal artifact revise <artifactId> --file v2.md                 # 리비전 기록
gobi personal artifact revise <artifactId> --from <revId> --file alt.md # 특정 리비전에서 분기
gobi personal artifact revert <artifactId> --revision <revId>           # 이전 리비전 복원
gobi personal artifact history <artifactId>                             # 전체 트리, owner 전용

리비전은 히스토리 트리를 이루고, 가장 최근 노드가 그 아티팩트의 현재 내용입니다. revert는 이전 리비전의 내용을 새 리비전으로 다시 올립니다. 되감지 않으니 기록이 그대로 남아요. 이 트리 덕분에 에이전트가 초안을 쓰되 결정은 사람이 쥡니다. 에이전트가 맥락을 끌어와 리비전을 쓰고 멈추면, 내가 읽고 고칠 곳을 말하고, 에이전트가 다시 고칩니다. --change-note는 그 리비전이 왜 생겼는지라서, history가 이 문서를 만든 논의처럼 읽힙니다.

읽고 지우기

gobi personal artifact list                  # 최신순, --kind로 거르기
gobi personal artifact get <artifactId>
gobi personal artifact download <artifactId> --out ./file   # 기본은 현재 리비전
gobi personal artifact delete <artifactId>   # 아티팩트와 리비전 트리 전체 삭제

download --revision <revId>로 특정 리비전을 받을 수 있습니다.

아티팩트는 포스트에 붙이기 전까지 내 Home에 있습니다.

gobi space create-post --content "오늘 미팅 노트" --artifact <artifactId>

스페이스에 속한 아티팩트는 따로 없습니다. 포스트에 붙이는 것이 팀에 닿는 경로예요.

artifact는 플랫폼 레벨 객체입니다. 모바일 앱에서는 같은 객체를 앱이 쓰는 이름으로 만나요. 캡처는 노트가 됩니다. 사용자 가이드의 노트를 보세요.

Gobi CLI

API

아티팩트가 담는 것

종류

노트도 아티팩트입니다

만들기

고치기

읽고 지우기

공유하기

​아티팩트가 담는 것

​종류

​노트도 아티팩트입니다

​만들기

​고치기

​읽고 지우기

​공유하기

아티팩트가 담는 것

종류

노트도 아티팩트입니다

만들기

고치기

읽고 지우기

공유하기