Skip to main content
よく使う CLI コマンドを例で確認してください。

1. 最近のノートを一覧表示する

TTY での見やすい出力:
パイプ用に NDJSON へ切り替えるには --json を追加します:

2. キーワードと日付範囲で検索する

tiro notes search は全文検索を使い、主要ドキュメント(one-pager、custom)を結果に含めます。キーワードは位置引数または --keyword で指定します。 日付フィルターは ISO-8601 または相対表記の短縮形を受け付けます:
フォルダ単位での絞り込み:

キーワードマッチングの仕組み

tiro notes search は、ノートのタイトルと段落を全文検索します。大文字小文字は区別せず、"OKR planning" は両方の語を含むノートを探します。結果は関連度順で、スコアが同じ場合は createdAt の降順で並びます。 tiro notes searchPOST /v1/external/notes/search は、各ノートの主要ドキュメント(one-pager、custom)を併せて返します。tiro notes list --keyword "..." はメタデータのみを返します。 --keyword を指定しない場合、tiro notes listcreatedAt の降順で並べます。--keyword を指定した場合、ページカーソルは常に null です。
未完成のノートは除外されます。 tiro notes listtiro notes search は、title === "Untitled" または sourceType === "onboarding" のノートをデフォルトで除外します。含めるには --include-untitled を渡してください。

3. 1 件の会議ノートを Markdown として保存する

stdout にはメタデータが 1 行返り、実際のコンテンツはディスクに出力されます:
Markdown ファイルには YAML フロントマター、参加者リスト、そして段落ごとに 1 つの経過タイムスタンプヘッダーと、それに続く話者ごとのセグメントを含むトランスクリプトが格納されます:
--no-timestamps(v0.3.0+)を渡すと ### mm:ss ヘッダーを完全に除去できます。タイムスタンプがノイズになる生のままの保存や LLM への取り込みに便利です:

4. 検索結果を jq にパイプする

--json は list/search のレスポンスに対して常に NDJSON を出力します(ノート 1 件につき 1 行)。さらにパイプライン処理を行うには jq -c(コンパクト)と組み合わせ、スライスするには head / tail と組み合わせます。 レスポンスに次ページのカーソルが含まれる場合、それは _cursor をキーとする最後の NDJSON 行として出力されます:
続きを取得するには、それを --cursor として渡し直します:

5. 話者ラベル付きのトランスクリプトを取得する

MCP の get_note_transcript ペイロードをすでに理解しているエージェント向けには、--format json に切り替えてください。形式はバイト単位で同一です:

6. ワークスペースの Wiki を探索する

Wiki は、Tiro がノートから自動抽出したナレッジグラフ(エンティティ、コンセプト、およびそれらのリンク)です。これらのコマンドはすべて読み取り専用で、Wiki が有効化されたワークスペース(有料・オプトイン)が必要です。
--workspace は省略可能です。指定しない場合は、お使いの API Key のデフォルトワークスペースが使用されます。アカウントが複数のワークスペースに属している場合は、まず tiro wiki workspaces を実行し、Wiki が有効になっている guid を渡してください。ゲート対象のワークスペースでは、バックエンドのアップグレード案内が表示され、非ゼロの終了コードで終了します。 → ツール選択のガイダンスと実践的なエージェントフローについては For AI agents へ進んでください。