1. 最近のノートを一覧表示する
--json を追加します:
2. キーワードと日付範囲で検索する
tiro notes search は全文検索を使い、主要ドキュメント(one-pager、custom)を結果に含めます。キーワードは位置引数または --keyword で指定します。
日付フィルターは ISO-8601 または相対表記の短縮形を受け付けます:
キーワードマッチングの仕組み
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. 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 Key のデフォルトワークスペースが使用されます。アカウントが複数のワークスペースに属している場合は、まず tiro wiki workspaces を実行し、Wiki が有効になっている guid を渡してください。ゲート対象のワークスペースでは、バックエンドのアップグレード案内が表示され、非ゼロの終了コードで終了します。
→ ツール選択のガイダンスと実践的なエージェントフローについては For AI agents へ進んでください。