1. 最近のノートを一覧表示する
--json を追加します:
2. キーワードと日付範囲で検索する
tiro notes search は Tiro のディープ検索を使用します。各結果は、その主要ドキュメント（one-pager、custom）が付与されたノートです。キーワードは必須です（位置引数または --keyword）。
日付フィルターは ISO-8601 または相対表記の短縮形を受け付けます:
キーワードマッチングの仕組み
tiro notes search は、ノートのタイトルと段落コンテンツに対する Tiro の全文検索インデックスへクエリを発行します。マッチは大文字小文字を区別せず、トークン化されます。つまり "OKR planning" は、リテラルなフレーズではなく “OKR” と “planning” の両方を含むノートを返します。結果は関連度で並び替えられ、同点の場合は createdAt の降順がタイブレーカーになります。
ディープ版（このコマンド、POST /v1/external/notes/search）は、各ノートにその主要ドキュメント（one-pager、custom）も付与するため、LLM クライアントは 1 回の呼び出しでメタデータとコンテンツを併せて読み取れます。より軽量な tiro notes list --keyword "..." はメタデータのみを返します。
--keyword を指定しない場合、tiro notes list は結果を createdAt desc で並び替えます。--keyword を指定した場合、ページネーションカーソルは常に null になります（レスポンスは検索インデックスが返す範囲に限定されます）。
プレースホルダーフィルター。
tiro notes list と tiro notes search はいずれも、デフォルトでプレースホルダーのノート（title === "Untitled" または sourceType === "onboarding"）を除外します。N 件のページでも、表示されるノートが N 件未満になる場合があります。それらを表示するには --include-untitled を渡してください。3. 1 件の会議ノートを Markdown として保存する
--no-timestamps（v0.3.0+）を渡すと ### mm:ss ヘッダーを完全に除去できます。タイムスタンプがノイズになる生のままの保存や LLM への取り込みに便利です:
4. 検索結果を jq にパイプする
--json は list/search のレスポンスに対して常に NDJSON を出力します（ノート 1 件につき 1 行）。さらにパイプライン処理を行うには jq -c（コンパクト）と組み合わせ、スライスするには head / tail と組み合わせます。
レスポンスに次ページのカーソルが含まれる場合、それは _cursor をキーとする最後の NDJSON 行として出力されます:
--cursor として渡し直します:
5. 話者ラベル付きのトランスクリプトを取得する
get_note_transcript ペイロードをすでに理解しているエージェント向けには、--format json に切り替えてください。形式はバイト単位で同一です:
6. ワークスペースの Wiki を探索する
Wiki は、Tiro がノートから自動抽出したナレッジグラフ（エンティティ、コンセプト、およびそれらのリンク）です。これらのコマンドはすべて読み取り専用で、Wiki が有効化されたワークスペース（有料・オプトイン）が必要です。--workspace は省略可能です。指定しない場合は、お使いの API キーのデフォルトワークスペースが使用されます。アカウントが複数のワークスペースに属している場合は、まず tiro wiki workspaces を実行し、Wiki が有効になっている guid を渡してください。ゲート対象のワークスペースでは、バックエンドのアップグレード案内が表示され、非ゼロの終了コードで終了します。
→ ツール選択のガイダンスと実践的なエージェントフローについては For AI agents へ進んでください。