pp-render

Render — Printing Press CLI

前提条件：CLI をインストールする

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

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

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

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

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go を直接インストールしてください（Go 1.26.6 以降が必要です）。

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

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

この CLI を使う場面

リソースごとではなく、Render の利用状況全体を把握したい場合は render-pp-cli を使ってください。環境間の環境変数の反映、CI でのブループリントの差分チェック、月次コストの集計、プレビュー環境のクリーンアップ、監査ログのフォレンジックに適しています。render psql や render ssh のような単発の対話型ワークフローでは公式 CLI で十分です。render-pp-cli でも対応できますが、本領を発揮するのはダッシュボードには表示されない分析コマンドです。

独自の機能

この API で利用できる他のツールには、次の機能はありません。

積み重ねて活用できるローカル状態

• env diff — 任意の 2 つのサービス、環境グループ、またはサービスと環境グループの間で環境変数を比較します。3 者間の差分形式で表示します。

  環境間で設定を反映するときに使ってください。クリックして画面を切り替えることなく、実際の差分を把握する最も手軽な方法です。

  render-pp-cli env diff srv-staging-api srv-prod-api --json
  

• env promote — --only／--exclude／--dry-run を指定して、ソースのサービスまたは環境グループからターゲットへ環境変数をコピーします。

  開発専用のキーを持ち込まずに、動作確認済みのステージング設定を本番環境に反映するときに使ってください。

  render-pp-cli env promote --from srv-staging-api --to srv-prod-api --exclude DEBUG_TOKEN --dry-run
  

• drift — チェックイン済みの render.yaml とライブのワークスペースの状態を比較し、エンティティを名前ごとに追加・削除・変更に分類して報告します。

  誰かがブループリントではなくダッシュボードから本番環境を編集した場合にビルドを失敗させるため、CI で実行してください。

  render-pp-cli drift --blueprint render.yaml --json
  

• cost — サービス、Postgres、key-value、Redis、ディスクの月額コストを合計し、プロジェクト、環境、または所有者ごとにグループ化します。

  金曜日のコストレビューや、「この 3 つのサービスをダウンサイジングしたらどうなるか」と経理から尋ねられたときに使ってください。

  render-pp-cli cost --group-by project --json
  

• rightsize — 各サービスについて、直近の --since 7d の CPU とメモリを取得し、p95 使用率を算出して、プランの容量に対する --high または --low のしきい値を超えているサービスにフラグを付けます。

  手早くダウンサイジングできるサービスや、スロットリングが発生しそうなサービスを見つけるため、コスト集計の前に実行してください。

  render-pp-cli rightsize --since 7d --high 80 --low 20 --json
  

ライフサイクルの健全性維持

• preview-cleanup — --stale-days N より古いプレビューサービスを一覧表示します。--confirm を指定すると一括削除します。

  月額請求額が急増し、孤立したプレビュー環境が疑われるときに使ってください。

  render-pp-cli preview-cleanup --stale-days 14 --confirm
  

• orphans — 未接続のディスク、空の環境グループ、削除済みサービスを参照するカスタムドメイン、どのサービスからも参照されていないレジストリ認証情報、保持期間を超えたディスクスナップショットを見つけます。

  監査に向けたクリーンアップ、請求のレビュー、SOC 2 の証跡収集は、すべてここから始められます。

  render-pp-cli orphans --json
  

エージェントネイティブな基盤機能

• env where — 指定した環境変数キーについて、そのキーを定義しているすべてのサービスと環境グループを、ハッシュ、長さ、最終変更日時とともに一覧表示します（値そのものは表示しません）。

  認証情報のローテーション時や「このシークレットを使っているのは誰か」の監査時に、最初に実行します。

  render-pp-cli env where STRIPE_KEY --json
  

• incident-timeline — 指定した期間について、1 つのサービスのデプロイ、イベント、監査ログを統合し、時系列の表にまとめます。

  デプロイ後、午前 2 時にアラートを受けたとき、オンコール担当者が最初に実行すべきコマンドです。

  render-pp-cli incident-timeline srv-checkout-api --since 2h --json
  

• audit search — キャッシュされた監査ログを、実行者、対象、アクション、期間で FTS5 検索します。

  SOC 2 の証拠収集や、「前四半期にこのキーをローテーションしたのは誰か」という確認に使用します。

  render-pp-cli audit search --actor [email protected] --target STRIPE_KEY --since 30d --json
  

• deploys diff — 1 つのサービスの 2 つのデプロイ間で、コミット範囲、環境変数の変更、イメージタグの変更、プラン／リージョン／スケールの変更を表示します。

  デプロイ後のリグレッションをトリアージする際に最初に実行するコマンドです。「実際に何が変わったか」がわかります。

  render-pp-cli deploys diff srv-checkout-api dep-aaa dep-bbb --json
  

コマンドリファレンス

blueprints — Blueprints を使用すると、render.yaml ファイルでリソースを定義し、Render サービスへの変更を自動的に同期できます。 API では、Blueprints を使用したリソースの作成と管理方法を制御できます。

• render-pp-cli blueprints disconnect — 指定した ID の Blueprint を切断します。Blueprint を切断すると、リソースの自動同期が停止します...
• render-pp-cli blueprints list — 指定したワークスペースの Blueprints を一覧表示します。ワークスペースを指定しない場合は、API キーがアクセスできるすべての Blueprints を返します...
• render-pp-cli blueprints retrieve — 指定した ID の Blueprint を取得します。
• render-pp-cli blueprints update — 指定した ID の Blueprint を更新します。
• render-pp-cli blueprints validate — リソースを作成または変更せずに、render.yaml Blueprint ファイルを検証します。このエンドポイントは構文をチェックします...

cron-jobs — cron ジョブを管理します

disks — Disks を使用すると、サービスに永続ストレージを接続できます。

• render-pp-cli disks add — Web サービス、プライベートサービス、またはバックグラウンドワーカーに永続ディスクを接続します。サービスを再デプロイする必要があります...
• render-pp-cli disks delete — サービスに接続された永続ディスクを削除します。ディスク上のデータはすべて失われます。 ディスクに関連付けられたサービス...
• render-pp-cli disks list — 指定したフィルターに一致する永続ディスクを一覧表示します。フィルターを指定しない場合は、利用可能なすべてのディスクを返します...
• render-pp-cli disks retrieve — 指定した ID の永続ディスクを取得します。
• render-pp-cli disks update — 指定した ID の永続ディスクを更新します。ディスクに関連付けられたサービスがデプロイ済みで、アクティブである必要があります...

env-groups — 環境グループを管理します

• render-pp-cli env-groups create — 新しい環境グループを作成します。
• render-pp-cli env-groups delete — 指定した ID の環境グループを、その環境変数と含まれるシークレットファイルすべてとともに削除します。
• render-pp-cli env-groups list — 指定したフィルターに一致する環境グループを一覧表示します。フィルターを指定しない場合は、すべての環境グループが返されます。
• render-pp-cli env-groups retrieve — ID で環境グループを取得します。
• render-pp-cli env-groups update — 環境グループの属性を更新します。

environments — 環境を管理します

• render-pp-cli environments create — 指定した ID のプロジェクトに属する新しい環境を作成します。

• render-pp-cli environments delete — 指定した ID の環境を削除します。環境が空である必要があります（つまり、サービスが含まれていてはいけません...

• render-pp-cli environments list — 指定したフィルターに一致する、特定のプロジェクトの環境を一覧表示します。フィルターを指定しない場合は、すべての環境...

• render-pp-cli environments retrieve — 指定した ID の環境を取得します。

• render-pp-cli environments update — 指定した ID の環境の詳細を更新します。 events — サービス、Postgres、またはキー・バリューのイベントを表示します。

• render-pp-cli events <eventId> — 特定のイベントの詳細を取得します。

key-value — キー・バリューを使用すると、Render のキー・バリューインスタンスを操作できます。

• render-pp-cli key-value create — 新しいキー・バリューインスタンスを作成します。
• render-pp-cli key-value delete — ID を指定してキー・バリューインスタンスを削除します。
• render-pp-cli key-value list — 指定したフィルターに一致するキー・バリューインスタンスを一覧表示します。フィルターを指定しない場合は、すべてのキー・バリューインスタンスが...
• render-pp-cli key-value retrieve — ID を指定してキー・バリューインスタンスを取得します。
• render-pp-cli key-value update — ID を指定してキー・バリューインスタンスを更新します。

logs — ログを使用すると、サービス、Postgres データベース、redis インスタンスのログを取得できます。 ログをクエリしたり、WebSocket 経由でリアルタイムにログを購読したりできます。

• render-pp-cli logs delete-owner-stream — 指定したワークスペースのログストリームを削除します。
• render-pp-cli logs delete-resource-stream — 指定したリソースのログストリームのオーバーライドを削除します。削除後、リソースはワークスペースの...
• render-pp-cli logs get-owner-stream — 指定したワークスペースのログストリーム情報を返します。
• render-pp-cli logs get-resource-stream — 指定したリソースのログストリームのオーバーライド情報を返します。ログストリームのオーバーライドは...
• render-pp-cli logs list — 指定したフィルターに一致するログを一覧表示します。ログは開始および終了のタイムスタンプでページ分割されます。さらにログが...
• render-pp-cli logs list-resource-streams — 指定したフィルターに一致する、指定したワークスペースのログストリームのオーバーライドを一覧表示します。これらのオーバーライドは...
• render-pp-cli logs list-values — 指定したフィルターに一致するログの、指定したログラベルの値をすべて一覧表示します。
• render-pp-cli logs subscribe — 指定したフィルターに一致するログを購読するために、WebSocket 接続を開きます。ログはリアルタイムでストリーミングされ...
• render-pp-cli logs update-owner-stream — 指定したワークスペースのログストリーム情報を更新します。このワークスペースが所有するリソースのすべてのログは...
• render-pp-cli logs update-resource-stream — 指定したリソースのログストリームのオーバーライド情報を更新します。ログストリームのオーバーライドは...

maintenance — Maintenance エンドポイントを使用すると、Render サービスの最新のメンテナンス実行を取得できます。メンテナンスのスケジュールを変更したり、すぐに開始するように指示したりすることもできます。

• render-pp-cli maintenance list — 指定したリソースの、スケジュール済みおよび／または最近のメンテナンス実行を一覧表示します。
• render-pp-cli maintenance retrieve — 指定した ID のメンテナンス実行を取得します。
• render-pp-cli maintenance update — 指定した ID のメンテナンス実行を更新します。このエンドポイントからの更新は非同期です。更新を確認するには...

metrics — Metrics エンドポイントを使用すると、サービス、Postgres データベース、redis インスタンスのメトリクスを取得できます。

• render-pp-cli metrics get-active-connections — 1 つ以上の Postgres データベースまたは Redis インスタンスのアクティブな接続数を取得します。
• render-pp-cli metrics get-bandwidth — 1 つ以上のリソースの帯域幅使用量を取得します。
• render-pp-cli metrics get-bandwidth-sources — 1 つ以上のリソースの帯域幅使用量を、トラフィックソース（HTTP、WebSocket、NAT、PrivateLink）別に取得します。....
• render-pp-cli metrics get-cpu — 1 つ以上のリソースの CPU 使用量を取得します。
• render-pp-cli metrics get-cpu-limit — 1 つ以上のリソースの CPU 上限を取得します。
• render-pp-cli metrics get-cpu-target — 1 つ以上のリソースの CPU ターゲットを取得します。
• render-pp-cli metrics get-disk-capacity — 1 つ以上のリソースの永続ディスク容量を取得します。
• render-pp-cli metrics get-disk-usage — 1 つ以上のリソースの永続ディスク使用量を取得します。
• render-pp-cli metrics get-http-latency — 1 つ以上のリソースの HTTP レイテンシーメトリクスを取得します。
• render-pp-cli metrics get-http-requests — 1 つ以上のリソースの HTTP リクエスト数を取得します。
• render-pp-cli metrics get-instance-count — 1 つ以上のリソースのインスタンス数を取得します。
• render-pp-cli metrics get-memory — 1 つ以上のリソースのメモリ使用量を取得します。
• render-pp-cli metrics get-memory-limit — 1 つ以上のリソースのメモリ上限を取得します。
• render-pp-cli metrics get-memory-target — 1 つ以上のリソースのメモリターゲットを取得します。
• render-pp-cli metrics get-replication-lag — Postgres レプリカのレプリケーション遅延時間を秒単位で取得します。
• render-pp-cli metrics get-task-runs-completed — 1 つ以上のタスクについて、完了したタスク実行の合計数を取得します。必要に応じて状態（成功／失敗）で絞り込めます。または...
• render-pp-cli metrics get-task-runs-queued — 1 つ以上のタスクについて、キューに登録されたタスク実行の合計数を取得します。
• render-pp-cli metrics list-application-filter-values — 1 つ以上のリソースでフィルターに使用できるインスタンス値を一覧表示します。
• render-pp-cli metrics list-http-filter-values — 1 つ以上のリソースでフィルターに使用できるステータスコードとホスト値を一覧表示します。
• render-pp-cli metrics list-path-filter-values — パスの候補は、指定されたフィルターで絞り込んだ最新 5000 行のログに基づいています。

metrics-stream — メトリクスストリームを管理します

• render-pp-cli metrics-stream delete-owner — 指定したワークスペースのメトリクスストリームを削除します。
• render-pp-cli metrics-stream get-owner — 指定したワークスペースのメトリクスストリーム情報を返します。
• render-pp-cli metrics-stream upsert-owner — 指定したワークスペースのメトリクスストリームを作成または更新します。

notification-settings — 通知設定では、受け取りたい通知と通知の受信先を設定できます。

• render-pp-cli notification-settings list-notification-overrides — 指定したフィルターに一致する通知のオーバーライドを一覧表示します。フィルターを指定しない場合は、すべての通知を返します...
• render-pp-cli notification-settings patch-owner — 指定した ID のオーナーの通知設定を更新します。
• render-pp-cli notification-settings patch-service-notification-overrides — 指定した ID のサービスの通知オーバーライドを更新します。
• render-pp-cli notification-settings retrieve-owner — 指定した ID のオーナーの通知設定を取得します。このコマンドにはオーナー ID を指定します...
• render-pp-cli notification-settings retrieve-service-notification-overrides — 指定した ID のサービスの通知オーバーライドを取得します。このコマンドにはサービス ID を指定します...

organizations — 組織を管理します

owners — オーナーを管理します

• render-pp-cli owners list — API キーでアクセスできるワークスペースを一覧表示します。名前またはオーナーのメールアドレスで絞り込むこともできます。

• render-pp-cli owners retrieve — 指定した ID のワークスペースを取得します。ワークスペース ID は tea- で始まります。ユーザー ID（次で始まるもの）を指定した場合は... postgres — Postgres エンドポイントを使用して、Render Postgres データベースを操作できます。 データベース、エクスポート、復旧、フェイルオーバーを管理できます。

• render-pp-cli postgres create — 新しい Postgres インスタンスを作成します。

• render-pp-cli postgres delete — ID を指定して Postgres インスタンスを削除します。この操作は取り消せず、すべてのデータが失われます。

• render-pp-cli postgres list — 指定したフィルターに一致する Postgres インスタンスを一覧表示します。フィルターを指定しない場合は、すべての Postgres インスタンスが返されます。

• render-pp-cli postgres retrieve — ID を指定して Postgres インスタンスを取得します。

• render-pp-cli postgres update — ID を指定して Postgres インスタンスを更新します。

projects — プロジェクトを管理します

• render-pp-cli projects create — 新しいプロジェクトを作成します。
• render-pp-cli projects delete — 指定した ID のプロジェクトを削除します。プロジェクト内のすべての環境が空である必要があります（つまり、それらの環境は...
• render-pp-cli projects list — 指定したフィルターに一致するプロジェクトを一覧表示します。フィルターを指定しない場合は、すべてのプロジェクトが返されます。
• render-pp-cli projects retrieve — 指定した ID のプロジェクトを取得します。
• render-pp-cli projects update — プロジェクトの詳細を更新します。プロジェクト内の特定の 環境 の詳細を更新するには、代わりに次を使用します...

redis — redis を管理します

• render-pp-cli redis create — 新しい Redis インスタンスを作成します。この API は非推奨であり、Key Value API の使用が推奨されています。
• render-pp-cli redis delete — ID を指定して Redis インスタンスを削除します。この API は非推奨であり、Key Value API の使用が推奨されています。
• render-pp-cli redis list — 指定したフィルターに一致する Redis インスタンスを一覧表示します。フィルターを指定しない場合は、すべての Redis インスタンスが返されます...
• render-pp-cli redis retrieve — ID を指定して Redis インスタンスを取得します。この API は非推奨であり、Key Value API の使用が推奨されています。
• render-pp-cli redis update — ID を指定して Redis インスタンスを更新します。この API は非推奨であり、Key Value API の使用が推奨されています。

registrycredentials — registrycredentials を管理します

• render-pp-cli registrycredentials create-registry-credential — 新しいレジストリ認証情報を作成します。
• render-pp-cli registrycredentials delete-registry-credential — 指定した ID のレジストリ認証情報を削除します。
• render-pp-cli registrycredentials list-registry-credentials — 指定したフィルターに一致するレジストリ認証情報を一覧表示します。フィルターを指定しない場合は、すべてのレジストリ...
• render-pp-cli registrycredentials retrieve-registry-credential — 指定した ID のレジストリ認証情報を取得します。
• render-pp-cli registrycredentials update-registry-credential — 指定した ID のレジストリ認証情報を更新します。この認証情報を使用するサービスは、使用するために再デプロイする必要があります...

services — サービスを使用すると、ウェブサービス、プライベートサービス、バックグラウンドワーカー、cron ジョブ、静的サイトを管理できます。

• render-pp-cli services create — 指定したワークスペースに、指定した構成で新しい Render サービスを作成します。
• render-pp-cli services delete — 指定した ID のサービスを削除します。
• render-pp-cli services list — 指定したフィルターに一致するサービスを一覧表示します。フィルターを指定しない場合は、権限のあるすべてのサービスが返されます...
• render-pp-cli services retrieve — 指定した ID のサービスを取得します。
• render-pp-cli services update — 指定した ID のサービスを更新します。

task-runs — タスク実行を管理します

• render-pp-cli task-runs cancel — 指定された ID の実行中のタスク実行をキャンセルします。
• render-pp-cli task-runs create-task — 指定された ID のワークフロータスクの実行を、指定された入力データを渡して開始します。
• render-pp-cli task-runs get — 指定された ID のワークフロータスク実行を取得します。
• render-pp-cli task-runs list — 指定されたフィルターに一致するタスク実行を一覧表示します。フィルターが指定されていない場合は、アクセス可能なすべてのタスク実行を...
• render-pp-cli task-runs stream-events — 単方向のイベントストリームを確立します。サーバーは SSE 仕様に従ってフォーマットされた行としてイベントを送信します。クライアント...

tasks — タスクを管理します

• render-pp-cli tasks get — 指定された ID のワークフロータスクを取得します。
• render-pp-cli tasks list — 指定されたフィルターに一致するワークフロータスクを一覧表示します。フィルターが指定されていない場合は、アクセス可能なすべてのタスク定義を...

users — User エンドポイントを使用すると、認証されたユーザーに関する情報を取得できます

• render-pp-cli users — 指定された API キーに関連付けられたユーザーを取得します。

webhooks — Webhooks を使用すると、Render webhook の設定を管理できます。

• render-pp-cli webhooks create — 新しい webhook を作成します。
• render-pp-cli webhooks delete — 指定された ID の webhook を削除します。
• render-pp-cli webhooks list — webhook を一覧表示します
• render-pp-cli webhooks retrieve — 指定された ID の webhook を取得します
• render-pp-cli webhooks update — 指定された ID の webhook を更新します。

workflows — ワークフローを管理します

• render-pp-cli workflows create — 指定された設定で新しいワークフローサービスを作成します。
• render-pp-cli workflows delete — 指定された ID のワークフローサービスを削除します。
• render-pp-cli workflows get — 指定された ID のワークフローサービスを取得します。
• render-pp-cli workflows list — 指定されたフィルターに一致するワークフローを一覧表示します。フィルターが指定されていない場合は、アクセス可能なすべてのワークフローを...
• render-pp-cli workflows update — 指定された ID のワークフローサービスを更新します。

workflowversions — workflowversions を管理します

• render-pp-cli workflowversions create-workflow-version — ワークフローの新しいバージョンを作成してデプロイします。
• render-pp-cli workflowversions get-workflow-version — 指定された ID の特定のワークフローサービスのバージョンを取得します。
• render-pp-cli workflowversions list-workflow-versions — 指定された ID のワークフローサービスについて既知のバージョンを一覧表示します。

適切なコマンドを見つける

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

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

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

レシピ

ステージング環境を本番環境に昇格させ、デバッグキーを除外する

render-pp-cli env promote --from srv-staging --to srv-prod --exclude DEBUG_TOKEN,SENTRY_DEV_DSN

まず diff で何が変更されるかを確認し、次に開発専用キーを除外して昇格させます。実際に書き込みを発行するには、確認後に --apply を追加してください。

シークレットをローテーションする前に、それを利用しているすべてのサービスを見つける

render-pp-cli env where STRIPE_KEY --json --select 'service.name,service.id,updatedAt'

STRIPE_KEY が参照されているすべての場所について、サービス名、ID、タイムスタンプを返します — これがローテーションのチェックリストです。

プロジェクト別にグループ化した金曜日のコスト集計

render-pp-cli cost --group-by project --json --select 'project,monthly_usd,resource_count'

キャッシュされた service/postgres/kv/disk のプランを厳選された価格テーブルと結合します。財務向けに CSV へエクスポートできます。

CI でブループリントのドリフトを検出する

render-pp-cli drift --blueprint render.yaml --json --quiet || exit 1

ライブワークスペースがチェックインされたブループリントから逸脱している場合に非ゼロで終了します。CI パイプラインに組み込んでください。

直近 2 時間にわたるサービスのインシデントタイムライン

render-pp-cli incident-timeline srv-checkout-api --since 2h --json --select 'timestamp,kind,actor,summary'

デプロイ + イベント + 監査ログを 1 つの時系列テーブルにマージします — オンコールのページ中に「何が変わったか」に答えます。

認証の設定

Render はベアラートークン認証を使用します。RENDER_API_KEY を設定するか（https://dashboard.render.com/u/settings#api-keys で生成）、render-pp-cli auth set-token <RENDER_API_KEY> を実行して対話形式で貼り付けます。すべてのコマンドは Authorization: Bearer <key> を送信し、doctor はキーが有効かどうかを検証します。

render-pp-cli doctor を実行して設定を確認します。

エージェントモード

任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — stdout には JSON、stderr にはエラーが出力されます

• フィルタ可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストされた構造をたどり、配列は各要素をたどります。出力の多い API でコンテキストを小さく保つために重要です：

  render-pp-cli blueprints list --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 に問題があると気づいた場合は、あなた自身またはエージェントが、その内容を記録してください：

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

エントリーはローカルの ~/.render-pp-cli/feedback.jsonl に保存されます。RENDER_FEEDBACK_ENDPOINT が設定されており、かつ --send が渡されるか RENDER_FEEDBACK_AUTO_SEND=true が設定されている場合を除き、POST されることはありません。既定の動作ではローカルのみに保存されます。

バグ報告ではなく、意外に感じたことを書いてください。短く、具体的に、1 行で記録してください。それが積み重なって役立ちます。

出力の配信

すべてのコマンドで --deliver <sink> を指定できます。出力は、標準出力に加えて、または標準出力の代わりに、指定したシンクに送られます。これにより、エージェントはコマンド結果を手動でパイプすることなく振り分けられます。利用できるシンクは 3 種類です：

シンク	動作
stdout	既定値。標準出力にのみ書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイルを作成してリネーム）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、利用可能なスキームを示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードを返し、URL と HTTP ステータスを stderr に記録します。

名前付きプロファイル

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

render-pp-cli profile save briefing --json
render-pp-cli --profile briefing blueprints list
render-pp-cli profile list --json
render-pp-cli profile show briefing
render-pp-cli profile delete briefing --yes

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

非同期ジョブ

時間のかかる処理を送信するエンドポイントでは、ジェネレーターが送信後にポーリングするパターン（レスポンスに job_id／task_id／operation_id フィールドがあり、対応するステータスエンドポイントがある場合）を検出し、送信コマンドに 3 つの追加フラグを設定します：

フラグ	目的
--wait	ジョブ ID をすぐに返す代わりに、ジョブが終了状態になるまで待機します
--wait-timeout	最大待機時間（既定値は 10m、0 はタイムアウトなし）
--wait-interval	初回のポーリング間隔（既定値は 2s。指数バックオフで最大 30s まで延長されます）

実行を開始したらすぐに戻したい場合は --wait なしで非同期送信を使用し、1 つのコマンドで完成した成果物を返したい場合は --wait を使用します。

終了コード

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

引数の解析

$ARGUMENTS を解析します。

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

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

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

claude mcp add render-pp-mcp -- render-pp-mcp

確認します：claude mcp list

直接使用

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

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

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