pp-roam

Roam — Printing Press CLI

前提条件：CLI のインストール

このスキルは roam-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**インストールされていない場合は、まずインストールします。

1. Printing Press インストーラーを使用してインストールします。バイナリの既定のインストール先は、macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin です。

   npx -y @mvanhorn/printing-press-library install roam --cli-only
   

2. 確認します：roam-pp-cli --version
3. 実行するエージェント／ランタイムの $PATH に、表示されたインストールディレクトリが含まれていることを確認します。

npx によるインストールが失敗した場合（Node がない、オフラインなど）は、Go を直接インストールする方法に切り替えます（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/productivity/roam/cmd/roam-pp-cli@latest

インストール後に --version が「command not found」と表示する場合、ランタイムからバイナリディレクトリを $PATH 経由で参照できていません。確認が成功するまで、スキルのコマンドを実行しないでください。

この CLI を使用する場面

シェルやエージェントから Roam HQ をスクリプトで操作する必要がある場合は、roam-pp-cli を使用してください。Webhook 配信を追跡する、デプロイ通知を投稿する、複数の会議のトランスクリプトを一度に検索する、SCIM のメンバーシップを HRIS の名簿と照合する、先週の録画から決定事項を抽出するといった用途に適しています。api.ro.am/mcp のリモート MCP はその場でのエージェントとのチャットに適していますが、パイプライン、cron、またはローカル優先の検索にはこの CLI が最適です。

独自の機能

これらの機能は、この API のほかのツールでは利用できません。

積み重ねられるローカルの状態

• grep — --since、--from-user、--in-meeting、--in-group フィルターを使って、すべてのチャットメッセージと会議のトランスクリプトを一度に検索します。

  エージェントがレート制限のあるトランスクリプト API を何度も呼び出さずに、複数の会議で何が話されたかを思い出す必要がある場合に使用します。

  roam-pp-cli grep "pricing" --since 14d --in-group eng --json --select transcript_id,line
  

• decisions — 同期済みのトランスクリプトから、決定事項の形式をした行（「we decided」、「action item」、「agreed」、「let's go with」）を抽出します。

  エージェントがチーム向けに月曜日の振り返りをまとめる必要がある場合に使用します。決定的で、引用元も提示します。

  roam-pp-cli decisions --since 7d --in-group product --agent
  

• onair-attendance-drift — On-Air イベントの招待ゲストと実際の出席者を比較し、招待されたが欠席した人と、招待なしで参加した人の一覧を出力します。

  誰が来なかったか、または招待なしで誰が参加したかをエージェントに尋ねられた場合に使用します。

  roam-pp-cli onair-attendance-drift --event evt_123 --json
  

• webhook-tail — ローカルのサブスクリプションレジストリから、最近の Webhook 配信を --since で絞り込んで追跡します。

  リスナーを立ち上げずに Webhook 統合をデバッグする場合に使用します。

  roam-pp-cli webhook-tail --since 1h --json
  

• mention-inbox — --since フィルターと追跡形式を使って、messages.text 内の @user トークンをローカル FTS で検索します。

  グループごとに API を呼び出さずに、すべてのグループで未読のメンションをエージェントが抽出する必要がある場合に使用します。

  roam-pp-cli mention-inbox --user @me --since 7d --agent
  

変更の安全性

• onair-reaper — N 日間出席者がいない定期的な On-Air イベントを検出します。--apply を指定すると、吸収されたキャンセルエンドポイントを使ってイベントをキャンセルします。

  停止した定期イベントを整理する場合に使用します。既定では安全です。

  roam-pp-cli onair-reaper --stale-days 60 --dry-run
  

• scim-diff — CSV/JSON 形式の HRIS 名簿と /Users の SCIM リストを比較し、追加／更新／削除の一覧を出力します。--apply を指定すると、SCIM CRUD を実行します。

  管理 UI を操作せずに、外部の名簿と Roam のメンバーシップを照合する必要がある場合に使用します。

  roam-pp-cli scim-diff --roster hris.csv --apply --dry-run
  

エージェント向けの連携機能

• transcript-fanout — 指定した期間のすべてのトランスクリプトに同じ質問を実行し、トランスクリプトごとに回答と引用を含む行を出力します。

  同じ質問を一件ずつ再プロンプトせずに、複数の会議をエージェントが調べる必要がある場合に使用します。

  roam-pp-cli transcript-fanout --question "did anyone mention Q3 hiring?" --since 30d --agent
  

• relay — 任意の標準入力行を、決定的な冪等性キーと 429 のバックオフを使って /chat.post 経由で Roam グループに転送します。

  カスタム Webhook を作成せずに、ストリーム（CI、アラート、ログ）を Roam に転送する必要がある場合に使用します。

  tail -F deploys.log | roam-pp-cli relay --to eng-deploys --idempotent-key-prefix deploys
  

到達可能性の対策

• doctor token — 仕様ファミリー（HQ、On-Air、Chat、SCIM、Webhooks）ごとに代表的な GET を 1 つ実行し、このキーで到達可能なファミリーを出力します。

  資格情報を使って試す前に、どの Roam コマンドが動作するかをエージェントが確認する必要がある場合に使用します。

  roam-pp-cli doctor token
  

コマンドリファレンス

addr-info — addr info を管理します

• roam-pp-cli addr-info — チャットアドレスの情報を取得します。チャットアドレスとは、チャットに参加できるあらゆるエンティティの名称で、たとえば...

app-uninstall — アプリのアンインストールを管理

• roam-pp-cli app-uninstall — アクセストークンを無効化し、アプリをアンインストールします。応答が成功すると、アクセストークンは以後...

chat-delete — チャットの削除を管理

• roam-pp-cli chat-delete — 以前に投稿したボットのメッセージを削除します。削除するメッセージは、ボットが所有している必要があります（アドレス ID で照合）。個人...

chat-history — チャット履歴を管理

• roam-pp-cli chat-history — 日付範囲（after/before）で絞り込んで、チャット内のメッセージを一覧表示します。結果の並び順は、フィルター...

chat-list — チャット一覧を管理

• roam-pp-cli chat-list — アクセス可能なすべてのチャットを一覧表示します。これには、ボットが追加されたすべての DM、MultiDM、チャンネルが含まれます。...

chat-post — チャットへの投稿を管理

• roam-pp-cli chat-post — チャットにメッセージを投稿します。メッセージには、プレーンな Markdown テキスト、リッチな Block Kit レイアウト、または...

chat-send-message — チャットメッセージの送信を管理

• roam-pp-cli chat-send-message — 指定された宛先にメッセージを送信します。現在、サポートしているのは単一のグループへの送信のみです...

chat-typing — チャットの入力状態を管理

• roam-pp-cli chat-typing — 応答を作成中であることを、ほかのチャット参加者に通知します。チャットを開いている場合は、「（ボット...

chat-update — チャットの更新を管理

• roam-pp-cli chat-update — 以前に投稿したボットのメッセージを編集します。更新後のメッセージには、プレーンな Markdown テキストまたはリッチな [Block...

group-add — グループへの追加を管理

• roam-pp-cli group-add — 1 人以上のグループメンバーや管理者を追加します。次のいずれかの条件を満たす場合、アプリはグループにメンバーを追加できます...

group-archive — グループのアーカイブを管理

• roam-pp-cli group-archive — ID でグループをアーカイブします。アクセス権： 組織のみ。必須スコープ： group:write --- OpenAPI 仕様：...

group-create — グループの作成を管理

• roam-pp-cli group-create — チャットに使用できるグループアドレスを作成します。管理者を指定したグループは「管理者のみ」モードで動作します...

group-members — グループメンバーを管理

• roam-pp-cli group-members — グループのメンバーを一覧表示します。次のいずれかの条件を満たす場合、アプリはメンバーを一覧表示できます：1. 公開グループである...

group-remove — グループからの削除を管理

• roam-pp-cli group-remove — 1 人以上のグループメンバーを削除します。次のいずれかの条件を満たす場合、アプリはグループからメンバーを削除できます...

group-rename — グループ名の変更を管理

• roam-pp-cli group-rename — ID でグループの名前を変更します。アプリが名前を変更できるのは、自身が管理者であるグループのみです。アクセス権： 組織のみ...

groups — グループを管理

• roam-pp-cli groups 02-create — Roam 組織に新しいグループを作成します。必須フィールド： displayName（最大 64 文字）。任意：...
• roam-pp-cli groups 02-delete — Roam のグループをアーカイブします。これは論理削除です。グループデータは保持されますが、非アクティブになります...
• roam-pp-cli groups 02-get — Roam Address ID で単一のグループを取得します。応答には、グループの displayName と members 配列が含まれます...
• roam-pp-cli groups 02-list — Roam 組織内のグループをページネーション付きで一覧表示します。ページネーション： startIndex（1 から始まる）と count を使用します...
• roam-pp-cli groups 02-patch — グループを部分的に更新します。グループ全体を置き換えずにメンバーを追加または削除する場合に使用します。**サポート対象...
• roam-pp-cli groups 02-replace — グループの属性を完全に置き換えます。members リスト全体が指定された値に置き換わります。**必須...

groups-list — グループ一覧を管理

• roam-pp-cli groups-list — ホーム Roam 内の、アーカイブされていないすべての公開グループを一覧表示します。アクセス権： 組織のみ。必須スコープ：...

item-upload — アイテムのアップロードを管理

• roam-pp-cli item-upload — ファイルをアップロードし、チャットメッセージの添付ファイルとして送信できるようにします。返されるオブジェクトには、アイテム ID が含まれており、これは...

lobby-booking-list — ロビー予約リストを管理

• roam-pp-cli lobby-booking-list — 特定のロビー設定の予約を、日付範囲（after/before）で絞り込んで一覧表示します。結果の順序は...

lobby-list — ロビーリストを管理

• roam-pp-cli lobby-list — アカウント内のアクティブなロビーを一覧表示します。ロビー URL は ro.am/{handle} または ro.am/{handle}/{slug} の形式です。- ...

magicast-info — magicast 情報を管理

• roam-pp-cli magicast-info — ID で magicast を取得します。アクセス： Organization および Personal。Personal モードでは、次の所有する magicast のみ...

magicast-list — magicast リストを管理

• roam-pp-cli magicast-list — Roam 内のすべての magicast を、時系列の降順で一覧表示します。アクセス： Organization および Personal。Personal モードでは...

meeting-list — ミーティングリストを管理

• roam-pp-cli meeting-list — ホーム Roam 内のすべてのミーティングを、日付範囲（after/before）で絞り込んで一覧表示します。結果の順序は...

meetinglink-create — meetinglink の作成を管理

• roam-pp-cli meetinglink-create — ミーティングリンクを作成します。アクセス： Organization および Personal。Organization モードでは、ホストをメールアドレスで指定します。Personal モードでは...

meetinglink-info — meetinglink 情報を管理

• roam-pp-cli meetinglink-info — ミーティングリンクを取得します。アクセス： Organization のみ。必須スコープ： meetinglink:read --- OpenAPI 仕様：...

meetinglink-update — meetinglink の更新を管理

• roam-pp-cli meetinglink-update — ミーティングリンクを更新します。アクセス： Organization のみ。必須スコープ： meetinglink:write --- OpenAPI 仕様：...

messageevent-export — messageevent のエクスポートを管理

• roam-pp-cli messageevent-export — アカウント内の DM とグループチャットを含む、日次のメッセージイベントエクスポートを取得します。アーカイブを利用する顧客の場合...

onair-attendance-list — onair の出席者リストを管理

• roam-pp-cli onair-attendance-list — On-Air イベントの出席レポートを返します。RSVP データと参加情報・滞在時間を組み合わせます。ゲストが...

onair-event-cancel — onair イベントのキャンセルを管理

• roam-pp-cli onair-event-cancel — On-Air イベントをキャンセルします。この操作は取り消せません。アクセス： Organization および Personal。必須スコープ：...

onair-event-create — onair イベントの作成を管理

• roam-pp-cli onair-event-create — 新しい On-Air イベントを作成します。カレンダーのホストは組織のメンバーである必要があります。Personal アクセストークンを使用する場合...

onair-event-info — onair イベント情報を管理

• roam-pp-cli onair-event-info — 単一の On-Air イベントの詳細を返します。アクセス： Organization および Personal。必須スコープ： onair:read...

onair-event-list — onair イベントリストを管理

• roam-pp-cli onair-event-list — 組織の On-Air イベントをページ分けして一覧表示します。結果は開始時刻の降順で並べ替えられます...

onair-event-update — onair イベントの更新を管理

• roam-pp-cli onair-event-update — 既存の On-Air イベントを更新します。リクエスト本文で指定したフィールドのみが更新され、省略されたフィールドは...

onair-guest-add — onair ゲストの追加を管理

• roam-pp-cli onair-guest-add — On-Air イベントに 1 人以上のゲストを追加します。アクセス： Organization および Personal。必須スコープ： onair:write...

onair-guest-info — onair ゲスト情報を管理

• roam-pp-cli onair-guest-info — 単一の On-Air イベントゲストの詳細を返します。アクセス： Organization および Personal。必須スコープ：...

onair-guest-list — onair ゲストリストを管理

• roam-pp-cli onair-guest-list — On-Air イベントのゲストをページ分けして一覧表示します。RSVP ステータスで絞り込むこともできます。結果は...

onair-guest-remove — onair ゲストの削除を管理

• roam-pp-cli onair-guest-remove — On-Air イベントからゲストを削除します。アクセス： Organization および Personal。必須スコープ： onair:write ---... onair-guest-update — オンエアゲストの更新を管理

• roam-pp-cli onair-guest-update — ゲストの出欠確認ステータスを更新します。アクセス： 組織および個人。必須スコープ： onair:write ---...

reaction-add — リアクションの追加を管理

• roam-pp-cli reaction-add — チャット内のメッセージにリアクションを追加します。アクセス： 組織のみ。必須スコープ： chat:send_message または...

recording-list — 録画一覧を管理

• roam-pp-cli recording-list — ホーム Roam 内のすべての録画を、日付範囲（開始日／終了日）で絞り込んで一覧表示します。結果の順序は...

resource-types — リソースの種類を管理

• roam-pp-cli resource-types — Roam がサポートするリソースの種類（User と Group）の一覧を返します。この操作に認証は不要です...

schemas — スキーマを管理

• roam-pp-cli schemas 03-metadata-get — URN 識別子で指定した SCIM スキーマの定義を返します。この操作に...
• roam-pp-cli schemas 03-metadata-list — Roam がサポートするすべての SCIM スキーマを返します。コアの User スキーマと Group スキーマに加え、Roam のカスタムロール...

service-provider-config — サービスプロバイダー設定を管理

• roam-pp-cli service-provider-config — Roam の SCIM 機能とサポートされる機能を返します。このエンドポイントを使用すると、どの SCIM 操作が...

test — テストを管理

• roam-pp-cli test — テストエンドポイント

token-info — トークン情報を管理

• roam-pp-cli token-info — チャットアドレスなど、アクセストークンに関する情報を取得します。アクセス： 組織および個人。**...

transcript-info — 文字起こし情報を管理

• roam-pp-cli transcript-info — ホーム Roam から ID で文字起こしを取得します。完了済みの会議とライブ（進行中）の会議の両方に対応しています。ライブ...

transcript-list — 文字起こし一覧を管理

• roam-pp-cli transcript-list — ホーム Roam 内のすべての文字起こしを、日付範囲（開始日／終了日）で絞り込んで一覧表示します。このエンドポイントは文字起こし...

transcript-prompt — 文字起こしへのプロンプトを管理

• roam-pp-cli transcript-prompt — 特定の会議の文字起こしについて質問し、その内容に基づく AI 生成の回答を受け取ります。使用...

user-info — ユーザー情報を管理

• roam-pp-cli user-info — ID で指定した単一ユーザーの詳細情報を取得します。アクセス： 組織のみ。必須スコープ： user:read...

user-list — ユーザー一覧を管理

• roam-pp-cli user-list — アカウント内のすべてのユーザーを一覧表示します。ユーザーはアカウントに追加された順に返されます。アクセス：...

user-lookup — ユーザーを検索

• roam-pp-cli user-lookup — メールアドレスでアカウント内のユーザーを検索します。アクセス： 組織のみ。必須スコープ： user:read および...

userauditlog-list — ユーザー監査ログ一覧を管理

• roam-pp-cli userauditlog-list — アカウントのユーザー監査ログエントリー一覧を取得します。アクセス： 組織のみ。必須スコープ：...

users — ユーザーを管理

• roam-pp-cli users 01-create — Roam 組織に新しいユーザーをプロビジョニングします。必須フィールド： userName、name.givenName、...
• roam-pp-cli users 01-delete — Roam のユーザーをアーカイブします。これは論理削除です。ユーザーデータは保持されますが、アクセスできなくなります...
• roam-pp-cli users 01-get — Roam Person ID で単一ユーザーを取得します。応答には、すべてのユーザー属性、active ステータス、および...
• roam-pp-cli users 01-list — Roam 組織のユーザーをページ分割して返します。フィルタリング： SCIM フィルター式をサポートします。例：...
• roam-pp-cli users 01-patch — ユーザーを部分的に更新します。Roam のユーザー向け SCIM PATCH は、限定的なセマンティクスをサポートします。サポートされる操作： -...
• roam-pp-cli users 01-replace — ユーザーの属性をすべて置き換えます。リクエスト本文には必須フィールドをすべて指定する必要があります。**Roam 固有の...

webhook-subscribe — webhook のサブスクリプションを管理

• roam-pp-cli webhook-subscribe — 指定されたイベントの Webhook サブスクリプションを作成または更新します。同じイベントのサブスクリプションがすでに存在する場合...

webhook-unsubscribe — Webhook の購読解除を管理します

• roam-pp-cli webhook-unsubscribe — ID を指定して Webhook サブスクリプションを削除します。アクセス: 組織のみ。必要なスコープ: webhook:write ---...

適切なコマンドの見つけ方

やりたいことはわかっているが、どのコマンドがそれを行うかわからないときは、CLI に直接尋ねてください:

roam-pp-cli which "<capability in your own words>"

which は自然言語の機能クエリを、この CLI の厳選された機能インデックスから最適なコマンドに解決します。終了コード 0 は少なくとも 1 件の一致を意味し、終了コード 2 は確信のある一致がないことを意味します。その場合は --help にフォールバックするか、より絞り込んだクエリを使用してください。

レシピ

デイリースタンドアップのダイジェスト

roam-pp-cli decisions --since 1d --in-group standup --agent --select transcript_id,line,speaker

スタンドアップグループから昨日の決定事項を取得し、引用付きでエージェントが利用できる形式に整形します。

会議横断の質問スキャン

roam-pp-cli transcript-fanout --question "did anyone mention Q3 hiring?" --since 30d --agent

過去 30 日間のすべてのトランスクリプトに対して 1 つの質問を実行します。

HRIS 名簿と Roam SCIM の突き合わせ

roam-pp-cli scim-diff --roster hris.csv --apply --dry-run

適用前に追加/更新/削除のセットを確認します。実行するには --dry-run を外してください。

CI アラートを Roam にパイプする

tail -F /var/log/ci.log | roam-pp-cli relay --to eng-alerts --idempotent-key-prefix ci

CI ログの行を決定論的な重複排除とともに Roam グループへストリーミングします。

深くネストされたトランスクリプト応答の絞り込み

roam-pp-cli transcript-info --id <id> --json --select segments.speaker,segments.text

ドット区切りのパスを指定した --select を使用して、長いトランスクリプトでもエージェントのコンテキストを小さく保ちます。

認証のセットアップ

ROAM_API_KEY による Bearer 認証を使用します。Roam は 2 つのキーティアをサポートしています。フルアクセスの組織キーと、個人用アクセストークンです。一部の HQ v1 エンドポイントはフルアクセスを必要とし、Chat/Transcript v0 エンドポイントは PAT で動作します。roam-pp-cli doctor token を実行すると、自分のキーがどのファミリーに到達できるかを確認できます。

roam-pp-cli doctor を実行してセットアップを検証してください。

エージェントモード

任意のコマンドに --agent を追加します。これは次に展開されます: --json --compact --no-input --no-color --yes。

• パイプ可能 — stdout に JSON、stderr にエラー

• フィルタ可能 — --select はフィールドのサブセットを保持します。ドット区切りのパスはネストされた構造へと降りていき、配列は要素ごとにたどります。冗長な API でコンテキストを小さく保つために重要です:

  roam-pp-cli addr-info --agent --select id,name,status
  

• プレビュー可能 — --dry-run は送信せずにリクエストを表示します

• オフライン対応 — 同期/検索コマンドは、利用可能な場合にローカルの SQLite ストアを使用できます

• 非対話的 — 決してプロンプトを出さず、すべての入力はフラグです

• 明示的なリトライ — --idempotent は、すでに存在する作成を成功とみなすべき場合にのみ使用し、--ignore-missing は、存在しない削除対象を成功とみなすべき場合にのみ使用します

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力を来歴エンベロープで包みます:

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を、それがライブかローカルかを知るには .meta.source を解析してください。人間が読める N results (live) のサマリーは、stdout がターミナルの場合にのみ stderr に出力されます。パイプやエージェントのコンシューマーは、stdout で純粋な JSON を受け取ります。

エージェントからのフィードバック

あなた（またはエージェント）がこの CLI について何かおかしいと気づいたら、それを記録してください:

roam-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
roam-pp-cli feedback --stdin < notes.txt
roam-pp-cli feedback list --json --limit 10

エントリはローカルの ~/.roam-pp-cli/feedback.jsonl に保存されます。ROAM_FEEDBACK_ENDPOINT が設定されており、かつ --send が渡されるか ROAM_FEEDBACK_AUTO_SEND=true である場合を除き、決して POST されません。デフォルトの動作はローカルのみです。

バグレポートではなく、あなたが驚いたことを書いてください。短く、具体的に、1 行で。それが複利的に効いてくる部分です。

出力の配信

すべてのコマンドは --deliver <sink> を受け付けます。出力は stdout に加えて（または代わりに）指定されたシンクへ送られるため、エージェントは手動でパイプすることなくコマンドの結果をルーティングできます。3 つのシンクがサポートされています:

Sink	Effect
stdout	デフォルト。stdout のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（tmp + rename）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

未知のスキームは、サポートされているセットを明示した構造化エラーとともに拒否されます。Webhook の失敗は非ゼロを返し、URL と HTTP ステータスを stderr に記録します。

名前付きプロファイル

プロファイルは、保存したフラグ値のセットで、複数回の実行で再利用できます。スケジュールされたエージェントが、毎回同じ設定で同じコマンドを実行する場合に使用します。これは HeyGen の「Beacon」パターンです。

roam-pp-cli profile save briefing --json
roam-pp-cli --profile briefing addr-info
roam-pp-cli profile list --json
roam-pp-cli profile show briefing
roam-pp-cli profile delete briefing --yes

明示的に指定したフラグは常にプロファイル値より優先され、プロファイル値はデフォルト値より優先されます。agent-context は、利用可能なすべてのプロファイルを available_profiles の下に一覧表示するため、情報を参照するエージェントは実行時にプロファイルを検出できます。

終了コード

コード	意味
0	成功
2	使用方法エラー（引数が誤っています）
3	リソースが見つかりません
4	認証が必要です
5	API エラー（上流の問題）
7	レート制限中です（待ってから再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

1. 空、help、または --help → roam-pp-cli --help の出力を表示します
2. install で始まる → mcp で終わる場合は MCP のインストール、それ以外の場合は上記の前提条件を参照します
3. それ以外 → 直接使用（--agent を指定して CLI コマンドとして実行します）

MCP サーバーのインストール

この CLI の公開ライブラリエントリ、またはビルド済みリリースから MCP バイナリをインストールし、登録します。

claude mcp add roam-pp-mcp -- roam-pp-mcp

確認します：claude mcp list

直接使用

1. インストールされているか確認します：which roam-pp-cli 見つからない場合は、インストールを提案します（このスキルの最初にある前提条件を参照してください）。
2. ユーザーのクエリに最適なコマンドを、上記の「独自の機能」と「コマンドリファレンス」から選びます。
3. --agent フラグを指定して実行します。

   roam-pp-cli <command> [subcommand] [args] --agent
   

4. あいまいな場合は、サブコマンドのヘルプを確認します：roam-pp-cli <command> --help。