> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tiro.ooo/llms.txt
> Use this file to discover all available pages before exploring further.

# 빠른 시작

> 노트 나열부터 검색 결과를 셸로 대량 파이핑하기까지, 직접 해보는 다섯 가지 CLI 시나리오.

일상적인 CLI 워크플로 대부분을 다루는, 복사해서 바로 붙여넣을 수 있는 다섯 가지 시나리오예요. 각각은 데이터가 채워진 tenant에서 30초 안에 실행돼요.

## 1. 가장 최근 노트 나열하기

```bash theme={"system"}
tiro notes list --limit 10
```

TTY에서의 pretty 출력:

```
2026-04-02  note-a8f2c1...  18m32s  Q3 Planning
2026-04-01  note-b7e1d4...  12m05s  Customer call with Acme Corp
2026-03-29  note-c3f9a2...  45m11s  Engineering weekly standup
…
```

파이핑을 위해 NDJSON으로 바꾸려면 `--json`을 추가하세요:

```bash theme={"system"}
tiro notes list --limit 100 --json | jq -r '.guid' | head -5
```

## 2. 키워드와 날짜 범위로 검색하기

```bash theme={"system"}
tiro notes search "OKR" --since 30d --json
```

`tiro notes search`는 Tiro의 deep search를 써요. 각 결과는 primary document(one-pager, custom)로 hydrate된 노트예요. 키워드는 필수예요(positional 또는 `--keyword`).

날짜 필터는 ISO-8601 또는 상대 표기 단축형을 받아요:

```bash theme={"system"}
tiro notes search "Q3 Planning" --since 2026-04-01 --until 2026-05-01
tiro notes search "Acme Corp"   --since 7d
tiro notes search "release"     --since 24h
```

폴더 범위 지정:

```bash theme={"system"}
tiro notes search "deploy" --folder <folderId> --json
```

### 키워드 매칭이 동작하는 방식

`tiro notes search`는 노트 제목과 문단 콘텐츠에 대한 Tiro의 full-text search 인덱스를 쿼리해요. 매칭은 대소문자를 구분하지 않고 토큰화돼요. `"OKR planning"`은 "OKR"과 "planning"을 모두 포함하는 노트를 반환하며, 문구 그대로는 아니에요. 결과는 관련도 순으로 재정렬되고 `createdAt` desc가 동점 처리 기준이에요.

deep 변형(이 명령, `POST /v1/external/notes/search`)은 각 노트를 primary document(one-pager, custom)로 hydrate하기도 해서, LLM 클라이언트가 한 번의 호출로 메타데이터와 함께 콘텐츠를 읽을 수 있어요. 더 가벼운 `tiro notes list --keyword "..."`는 메타데이터만 반환해요.

`--keyword` 없이 `tiro notes list`는 결과를 `createdAt desc`로 정렬해요. `--keyword`를 쓰면 pagination cursor는 항상 `null`이에요(응답은 search 인덱스가 반환하는 것으로 한정돼요).

<Note>
  **Placeholder 필터.** `tiro notes list`와 `tiro notes search`는 둘 다 기본적으로 placeholder 노트를 걸러내요(`title === "Untitled"` 또는 `sourceType === "onboarding"`). N개의 페이지가 N개보다 적은 visible 노트를 반환할 수 있어요. 이들을 드러내려면 `--include-untitled`를 넘기세요.
</Note>

## 3. 회의 노트 하나를 Markdown으로 저장하기

```bash theme={"system"}
tiro notes get <noteGuid> --output ./q3-planning.md --include transcript
```

stdout은 메타데이터 한 줄을 반환하고, 실제 콘텐츠는 디스크로 가요:

```json theme={"system"}
{"ok":true,"data":{"saved":"./q3-planning.md","size":12450,"format":"md","guid":"note-a8f2c1...","title":"Q3 Planning"}}
```

Markdown 파일에는 YAML frontmatter, 참가자 목록, 그리고 문단마다 elapsed-timestamp 헤더 하나가 붙고 그 뒤에 화자가 표기된 segment가 오는 트랜스크립트가 들어 있어요:

```md theme={"system"}
### 00:12

**Yeoul**: Let's start with the Acme deal pipeline.
**Evan**: They just signed the LOI.
```

`### mm:ss` 헤더를 완전히 빼려면 `--no-timestamps`(v0.3.0+)를 넘기세요. timestamp가 노이즈가 되는 raw 저장이나 LLM ingest에 편리해요:

```bash theme={"system"}
tiro notes transcript <noteGuid> --output ./clean.md --no-timestamps
```

## 4. 검색 결과를 `jq`로 파이핑하기

```bash theme={"system"}
tiro notes search "OKR" --since 7d --json \
  | jq -r 'select(.recordingDurationSeconds > 600) | .guid' \
  > long-okr-meetings.txt
```

`--json`은 list/search 응답에 대해 항상 NDJSON을 내보내요. 노트 하나당 한 줄이에요. 후속 파이프라인을 위해 `jq -c`(compact)와 조합하거나, `head` / `tail`로 잘라내세요.

응답에 다음 페이지 cursor가 포함되면, `_cursor` 키가 붙은 마지막 NDJSON 줄로 내보내져요:

```bash theme={"system"}
tiro notes list --limit 50 --json | tail -1
# → {"_cursor":"eyJjcmVhdGVkQXQi…"}
```

계속하려면 그 값을 `--cursor`로 되돌려 넘기세요:

```bash theme={"system"}
tiro notes list --limit 50 --cursor "eyJjcmVhdGVkQXQi…"
```

## 5. 화자 라벨이 있는 트랜스크립트 가져오기

```bash theme={"system"}
tiro notes transcript <noteGuid> --format md --output ./transcript.md
```

```md theme={"system"}
# Customer call with Acme Corp

**Participants**: Yeoul, Evan, Hailey

## Transcript

### 00:00

**Yeoul**: Thanks for joining — let me walk through the proposal.

### 00:12

**Hailey**: One quick question on pricing tiers.

### 00:25

**Evan**: That's covered on slide 4.
…
```

MCP의 `get_note_transcript` payload를 이미 이해하는 에이전트라면 `--format json`으로 바꾸세요. shape이 바이트 단위로 동일해요:

```bash theme={"system"}
tiro notes transcript <noteGuid> --format json
```

```json theme={"system"}
{
  "noteGuid": "note-a8f2c1...",
  "title": "Customer call with Acme Corp",
  "participants": ["Yeoul", "Evan", "Hailey"],
  "createdAt": "2026-04-01T10:30:00Z",
  "recordingDurationSeconds": 3605,
  "paragraphs": [
    {
      "timeFrom": "2026-04-01T10:30:00Z",
      "timeTo":   "2026-04-01T10:30:12Z",
      "segments": [
        { "content": "Thanks for joining…",
          "speaker": { "label": "SPEAKER_0", "name": "Yeoul" } }
      ]
    },
    …
  ]
}
```

## 6. 워크스페이스 위키 둘러보기

위키는 내 노트 위에 Tiro가 자동으로 추출한 knowledge graph(엔티티, 개념, 그리고 그 사이의 링크)예요. 아래 명령들은 읽기 전용이고, 위키가 활성화된 워크스페이스(유료, opt-in)가 필요해요.

```bash theme={"system"}
tiro wiki workspaces                                   # which workspaces? (guid + wiki on/off)
tiro wiki search "payment system" --workspace <guid>   # ranked pages; <query> is positional
tiro wiki page <pageGuid> --workspace <guid>           # body + mentions + aliases + links (all included)
tiro wiki mentions <pageGuid> --workspace <guid>       # where the page is grounded in your notes
tiro wiki graph <pageGuid> --mode around --workspace <guid>    # neighborhood graph (capped — see `truncated`)
tiro wiki graph --mode seed --type CONCEPT --workspace <guid>  # overview graph — no pageGuid needed
```

`--workspace`는 선택이에요. 생략하면 내 API 키의 기본 워크스페이스를 써요. 계정이 둘 이상의 워크스페이스에 속해 있다면 먼저 `tiro wiki workspaces`를 실행해서 위키가 켜진 워크스페이스의 `guid`를 넘기세요. 게이트된 워크스페이스는 백엔드의 업그레이드 안내 메시지를 출력하고 0이 아닌 코드로 종료돼요.

→ 도구 선택 가이드와 실제로 풀어본 에이전트 플로를 보려면 [For AI agents](/ko/developers/cli/agent-guide)로 이어가세요.