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

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

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을 추가하세요: 
tiro notes list --limit 100 --json | jq -r '.guid' | head -5

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

tiro notes search "OKR" --since 30d --json
tiro notes search는 Tiro의 deep search를 써요. 각 결과는 primary document(one-pager, custom)로 hydrate된 노트예요. 키워드는 필수예요(positional 또는 --keyword). 날짜 필터는 ISO-8601 또는 상대 표기 단축형을 받아요: 
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
폴더 범위 지정: 
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 인덱스가 반환하는 것으로 한정돼요).
Placeholder 필터. tiro notes list와 tiro notes search는 둘 다 기본적으로 placeholder 노트를 걸러내요(title === "Untitled" 또는 sourceType === "onboarding"). N개의 페이지가 N개보다 적은 visible 노트를 반환할 수 있어요. 이들을 드러내려면 --include-untitled를 넘기세요.

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

tiro notes get <noteGuid> --output ./q3-planning.md --include transcript
stdout은 메타데이터 한 줄을 반환하고, 실제 콘텐츠는 디스크로 가요: 
{"ok":true,"data":{"saved":"./q3-planning.md","size":12450,"format":"md","guid":"note-a8f2c1...","title":"Q3 Planning"}}
Markdown 파일에는 YAML frontmatter, 참가자 목록, 그리고 문단마다 elapsed-timestamp 헤더 하나가 붙고 그 뒤에 화자가 표기된 segment가 오는 트랜스크립트가 들어 있어요: 
### 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에 편리해요: 
tiro notes transcript <noteGuid> --output ./clean.md --no-timestamps

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

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 줄로 내보내져요: 
tiro notes list --limit 50 --json | tail -1
# → {"_cursor":"eyJjcmVhdGVkQXQi…"}
계속하려면 그 값을 --cursor로 되돌려 넘기세요: 
tiro notes list --limit 50 --cursor "eyJjcmVhdGVkQXQi…"

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

tiro notes transcript <noteGuid> --format md --output ./transcript.md

# 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이 바이트 단위로 동일해요: 
tiro notes transcript <noteGuid> --format json

{
  "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)가 필요해요. 
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로 이어가세요.