빠른 시작

자주 쓰는 CLI 명령을 예제로 확인하세요.

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는 전문 검색을 사용하고 주요 문서(one-pager, custom)를 결과에 포함해요. 키워드는 위치 인자나 --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는 노트 제목과 문단을 전문 검색해요. 대소문자를 구분하지 않으며 "OKR planning"은 두 단어를 모두 포함한 노트를 찾아요. 결과는 관련도순이며 점수가 같으면 createdAt 내림차순으로 정렬해요. tiro notes search와 POST /v1/external/notes/search는 각 노트의 주요 문서(one-pager, custom)를 함께 반환해요. tiro notes list --keyword "..."는 메타데이터만 반환해요. --keyword 없이 tiro notes list를 호출하면 createdAt 내림차순으로 정렬해요. --keyword를 쓰면 페이지 커서는 항상 null이에요.

미완성 노트 제외. tiro notes list와 tiro notes search는 title === "Untitled" 또는 sourceType === "onboarding"인 노트를 기본적으로 제외해요. 포함하려면 --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로 이어가세요.

홈

시작하기

API

웹훅

MCP

CLI

개발자 리소스

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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