> ## 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가 캡처한 것으로 만들어낸 완성물 하나입니다. 미팅 요약이나 리포트, 이미지가 여기 해당해요. 플랫폼이 창작물을 담아두는 그릇이고, 모바일 앱의 **노트**가 그 종류 중 하나예요.

소유자는 항상 사람이고, 아티팩트는 내 **Home**에 있습니다. 스코프는 `gobi personal artifact …` 하나뿐이에요. 포스트에 붙이기 전까지는 나만 봅니다.

## 아티팩트가 담는 것

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

이 경계 덕분에 아티팩트를 안심하고 보낼 수 있습니다. 받는 사람이 여는 건 내가 건넨 그대로예요.

## 종류

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

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

### 노트도 아티팩트입니다

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

노트의 frontmatter에는 앱이 캡처에 대해 알고 있던 것이 담깁니다.

```yaml theme={null}
---
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`가 어느 캡처에서 왔는지 알려줍니다.

## 만들기

```sh theme={null}
# 마크다운: 파일, 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`를 주면 링크된 파일을 만들기 전에 웹드라이브로 올립니다.

## 고치기

```sh theme={null}
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`가 이 문서를 만든 논의처럼 읽힙니다.

## 읽고 지우기

```sh theme={null}
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에 있습니다.

```sh theme={null}
gobi space create-post --content "오늘 미팅 노트" --artifact <artifactId>
```

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

<Note>
  `artifact`는 플랫폼 레벨 객체입니다. 모바일 앱에서는 같은 객체를 앱이 쓰는 이름으로 만나요. 캡처는 **노트**가 됩니다. 사용자 가이드의 [노트](/ko/notes/overview)를 보세요.
</Note>