pp-cal-com

Cal.com — Printing Press CLI

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

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

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

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

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

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

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

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

この CLI を使う場面

エージェントが Cal.com のカレンダーを読み取ったり変更したりする必要があり、予約や再スケジュールに必要な API の複数回呼び出しでコンテキストを消費したくない場合は、cal-com-pp-cli を使用してください。ローカルストアにより、「カレンダーの予定は何か」「いつ空いているか」「誰に負荷が集中しているか」「どこで予定が競合しているか」といった質問に、ほぼ瞬時にオフラインで回答できます。トランザクション予約には、組み合わせて実行する book および reschedule next コマンドが適しています。それ以外の操作には、エンドポイントミラーの機能を利用できます。

独自の機能

この API で、ほかのツールでは利用できない機能です。

組み合わせて実行する予約フロー

• book — 空き枠の確認、任意の仮予約、作成、任意の確定を、1 回の組み合わせ呼び出しで行い、参加者をいずれかのイベントタイプに予約します。

  参加者をホストのカレンダーに登録するスクリプト用です（管理者によるオンボーディング、採用担当者による事前入力、テスト用フィクスチャなど）。参加者が自分で通常のフローに沿って時間を選ぶ場合は、代わりに link list の URL を共有してください。

  cal-com-pp-cli book --event-type-id 96531 --start 2026-05-06T17:00:00Z --attendee-name Guest --attendee-email [email protected] --dry-run
  

• slots find — 複数のイベントタイプ ID を対象に、開始時刻順に並べて、最も早く予約可能な空き枠を 1 回の呼び出しで検索します。

  どのイベントタイプが適切かわからない場合に使います。呼び出し元が、統合してランク付けされた一覧から選べるようにします。

  cal-com-pp-cli slots find --event-type-ids 96531 --start tomorrow --end "tomorrow 23:59" --json
  

• reschedule next — 指定した基準時刻以降で、既存の予約を同じイベントタイプの次の空き枠に移動します。

  直前の予定変更に使います。3 つのコマンドを実行する代わりに、安全なドライラン機能付きの 1 つのコマンドで対応できます。

  cal-com-pp-cli reschedule next --uid <booking-uid> --after tomorrow --dry-run
  

利用するほど充実するローカル状態

• agenda — ローカルストアから、今日、今週、または任意の期間の予約を指定した時間枠で取得します。

  エージェントが「カレンダーの予定は何か」を確認する必要がある場合に使います。任意の期間を対象に、1 つのコマンドで取得できます。

  cal-com-pp-cli agenda --window today --json --select id,start,title,attendees
  

• analytics no-show — 指定期間の無断キャンセル、キャンセル、予約数、密度の指標を取得します。analytics の関連サブコマンドには、bookings（予約数）、cancellations、no-show、density があります。比率を扱うコマンドでは --by に event-type、attendee、weekday を指定できます。analytics density --unit hour を指定すると、時間単位のヒートマップが追加されます。

  キャパシティ計画、無断キャンセルの傾向分析、参加者へのフォローアップに使います。単一の API 呼び出しでは得られない情報を取得できます。

  cal-com-pp-cli analytics no-show --window 90d --by attendee --json
  

• conflicts — 指定期間内で重複する予約を検出します。時間範囲が交差する予約の組み合わせが報告されます。ローカルストアを読み取るため、API 呼び出しはありません。

  確認メッセージを送信する前、または一括再スケジュールの後に実行します。API では警告なく許可される二重予約を検出できます。

  cal-com-pp-cli conflicts --window 7d --json
  

• gaps — 予定の空き時間のうち、予約されていない時間帯を、最小の時間枠サイズで絞り込んで検索します。

  キャパシティ計画に使います。「予定が何で埋まっているか」ではなく、「いつ会議を入れられるか」を確認できます。

  cal-com-pp-cli gaps --window 7d --min-minutes 60 --json
  

• workload — 指定期間におけるチームメンバー間の予約分布を示し、負荷が集中しているホストと、十分に活用されていないホストを明らかにします。

  ラウンドロビンの調整や、無断キャンセルとして表面化する前にホストの燃え尽きを察知するために使います。

  cal-com-pp-cli workload --team-id 42 --window 30d --json
  

• event-types stale — 過去 N 日間に予約が 0 件のイベントタイプを検索します。削除候補を特定できます。

  四半期ごとの整理に使い、予約可能なイベントタイプが実態からずれていくのを防ぎます。

  cal-com-pp-cli event-types stale --days 90 --json
  

ホストのコントロールサーフェス

• link create — Cal.com アカウントに新しい予約可能なリンク（イベントタイプ）を作成します。共有できる cal.com// の URL を出力します。

  ホストが行う主なクリエイティブな操作です。予約可能なリンクを使って参加者が時間を予約します。このコマンドでリンクを作成します。

  cal-com-pp-cli link create --slug 30min --length 30 --title "30 Min Meeting"
  

• link list — 所有している予約可能なリンクをすべて、コピーして共有できる完全な URL とともに一覧表示します。

  所有しているリンクを確認し、cal.com// を手作業で組み立てることなく URL を取得できます。

  cal-com-pp-cli link list --json
  

• ooo set — 日付範囲を指定して不在に設定し、その期間を Cal.com の空き時間検索から除外します。

  休暇中ですか？ 体調不良ですか？ これを一度実行すれば、予約されなくなります。オプションの --redirect-to-user を指定すると、予約をチームメイトに転送します（ラウンドロビンのみ）。

  cal-com-pp-cli ooo set --start 2026-05-12 --end 2026-05-18 --reason vacation --notes "Hawaii trip"
  

• ooo list — 現在有効な不在予定と今後の不在予定を一覧表示します。

  cal-com-pp-cli ooo list --json
  

エージェントネイティブの基盤

• webhooks coverage — 登録済みの Webhook トリガーを正式なセットと照合し、購読者がいないライフサイクルイベントを報告します。

  新しい自動化を追加するたびに実行してください。見落とされた BOOKING_NO_SHOW_UPDATED などのトリガーを、問題になる前に検出できます。

  cal-com-pp-cli webhooks coverage --json
  

コマンドリファレンス

api-keys — API キーを管理します

• cal-com-pp-cli api-keys — 新しい API キーを生成し、現在のキーを削除します。更新する API キーは Authorization の Bearer トークンとして指定します...

bookings — 予約を管理します

• cal-com-pp-cli bookings create — POST /v2/bookings は、通常の予約、繰り返し予約、即時予約の作成に使用します。リクエスト本文...
• cal-com-pp-cli bookings get — Headers セクションに記載されている cal-api-version ヘッダーの値を指定してください。指定しないと...
• cal-com-pp-cli bookings get-bookinguid — :bookingUid には、1. 通常の予約の UID、2. 繰り返し予約のいずれかの回の UID、3. の UID を指定できます...
• cal-com-pp-cli bookings get-by-seat-uid — 座席参照 UID を使って、座席予約を取得します。座席予約の seatUid がある場合に便利です。また...

cal-com-auth — Cal.com 認証を管理します

• cal-com-pp-cli cal-com-auth — RFC 6749 準拠のトークンエンドポイントです。リクエスト本文に client_id を渡します（Section 2.3.1）。grant_type を使用...

cal-com-auth-2 — Cal.com 認証 2 を管理します

• cal-com-pp-cli cal-com-auth-2 <clientId> — 指定されたクライアント ID の OAuth2 クライアント情報を返します

calendars — カレンダーを管理します

• cal-com-pp-cli calendars check-ics-feed — OAuth アクセストークンを使用してアクセスする場合、APPS_READ スコープが必要です。
• cal-com-pp-cli calendars create-ics-feed — OAuth アクセストークンを使用してアクセスする場合、APPS_WRITE スコープが必要です。
• cal-com-pp-cli calendars get — OAuth アクセストークンを使用してアクセスする場合、APPS_READ スコープが必要です。
• cal-com-pp-cli calendars get-busy-times — カレンダーの予定あり時間を取得します。リクエスト URL の例は https://api.cal.com/v2/calendars/busy-times?timeZone=Europe%2... です。

conferencing — カンファレンスを管理します

• cal-com-pp-cli conferencing get-default — OAuth アクセストークンを使用してアクセスする場合、APPS_READ スコープが必要です。
• cal-com-pp-cli conferencing list-installed-apps — OAuth アクセストークンを使用してアクセスする場合、APPS_READ スコープが必要です。

credits — クレジットを管理します

• cal-com-pp-cli credits charge — 完了した AI エージェントとのやり取りに対してクレジットを請求します。二重請求を防ぐ冪等性の確保に externalRef を使用します。
• cal-com-pp-cli credits get-available — 認証済みユーザー（またはその組織／チーム）が利用可能なクレジットを持っているかを確認し、現在の残高を返します。

destination-calendars — 送信先カレンダーを管理します

• cal-com-pp-cli destination-calendars — OAuth アクセストークンを使用してアクセスする場合、APPS_WRITE スコープが必要です。

event-types — イベントタイプを管理します

• cal-com-pp-cli event-types create — Headers セクションに記載されている cal-api-version ヘッダーの値を必ず渡してください。渡さない場合...
• cal-com-pp-cli event-types delete — Headers セクションに記載されている cal-api-version ヘッダーの値を必ず渡してください。渡さない場合...
• cal-com-pp-cli event-types get — 非表示のイベントタイプは、認証情報が提供され、その認証情報がイベントタイプの所有者に属している場合にのみ返されます。次を使用...
• cal-com-pp-cli event-types get-by-id — Headers セクションに記載されている cal-api-version ヘッダーの値を必ず渡してください。渡さない場合...
• cal-com-pp-cli event-types update — Headers セクションに記載されている cal-api-version ヘッダーの値を必ず渡してください。渡さない場合...

自分 — 自分の情報を管理

• cal-com-pp-cli me clear-my-booking-limits — 認証済みユーザーのすべてのグローバル予約制限を削除します。組織のメンバーのみが利用できます。組織に属していないユーザーは...
• cal-com-pp-cli me get — OAuth アクセストークンを使用してアクセスする場合は、PROFILE_READ スコープが必要です。
• cal-com-pp-cli me get-my-booking-limits — 認証済みユーザーのグローバル予約制限を返します。未設定の上限値は null として返されます。組織のメンバーのみが利用できます...
• cal-com-pp-cli me update — 認証済みユーザーのプロフィールを更新します。メールアドレスの変更には確認が必要で、プライマリメールアドレスは変更されません...
• cal-com-pp-cli me update-my-booking-limits — 認証済みユーザーのグローバル予約制限を部分的に更新します。リクエストボディに含まれるフィールドのみが...
• cal-com-pp-cli me user-ooocontroller-create-my-ooo — OAuth アクセストークンを使用してアクセスする場合は、SCHEDULE_WRITE スコープが必要です。
• cal-com-pp-cli me user-ooocontroller-delete-my-ooo — OAuth アクセストークンを使用してアクセスする場合は、SCHEDULE_WRITE スコープが必要です。
• cal-com-pp-cli me user-ooocontroller-get-my-ooo — OAuth アクセストークンを使用してアクセスする場合は、SCHEDULE_READ スコープが必要です。
• cal-com-pp-cli me user-ooocontroller-update-my-ooo — OAuth アクセストークンを使用してアクセスする場合は、SCHEDULE_WRITE スコープが必要です。

通知 — 通知を管理

• cal-com-pp-cli notifications subscriptions-register — アプリのプッシュサブスクリプションを登録します
• cal-com-pp-cli notifications subscriptions-remove — アプリのプッシュサブスクリプションを削除します

oauth — oauth を管理

oauth-clients — oauth クライアントを管理

• cal-com-pp-cli oauth-clients create — これらのエンドポイントは非推奨で、将来削除される予定です。
• cal-com-pp-cli oauth-clients delete — これらのエンドポイントは非推奨で、将来削除される予定です。
• cal-com-pp-cli oauth-clients get — これらのエンドポイントは非推奨で、将来削除される予定です。
• cal-com-pp-cli oauth-clients get-by-id — これらのエンドポイントは非推奨で、将来削除される予定です。
• cal-com-pp-cli oauth-clients update — これらのエンドポイントは非推奨で、将来削除される予定です。

organizations — 組織を管理

routing-forms — ルーティングフォームを管理

schedules — スケジュールを管理

• cal-com-pp-cli schedules create — 認証済みユーザーのスケジュールを作成します。スケジュールを作成する目的は、イベントタイプを利用可能にすることです...
• cal-com-pp-cli schedules delete — Headers セクションに記載されているとおり、cal-api-version ヘッダーの値を必ず渡してください。渡さないと...
• cal-com-pp-cli schedules get — 認証済みユーザーのすべてのスケジュールを取得します。Headers セクションに記載されているとおり、cal-api-version ヘッダーの値を必ず...
• cal-com-pp-cli schedules get-default — 認証済みユーザーのデフォルトのスケジュールを取得します。Headers セクションに記載されているとおり、cal-api-version ヘッダー...
• cal-com-pp-cli schedules get-scheduleid — Headers セクションに記載されているとおり、cal-api-version ヘッダーの値を必ず渡してください。渡さないと...
• cal-com-pp-cli schedules update — Headers セクションに記載されているとおり、cal-api-version ヘッダーの値を必ず渡してください。渡さないと...

selected-calendars — 選択したカレンダーを管理します

• cal-com-pp-cli selected-calendars add — OAuth アクセストークンを使用してアクセスする場合、APPS_WRITE スコープが必要です。
• cal-com-pp-cli selected-calendars delete — OAuth アクセストークンを使用してアクセスする場合、APPS_WRITE スコープが必要です。

slots — スロットを管理します

• cal-com-pp-cli slots delete-reserved — Headers セクションに記載されているとおり、cal-api-version ヘッダーの値を必ず渡してください。渡さないと...
• cal-com-pp-cli slots get-available — 個人ユーザーのイベントタイプで利用可能なスロットを取得する方法は 4 つあります。1. イベントタイプ ID による方法。例...
• cal-com-pp-cli slots get-reserved — Headers セクションに記載されているとおり、cal-api-version ヘッダーの値を必ず渡してください。渡さないと...
• cal-com-pp-cli slots reserve — 一定期間、そのスロットを他のユーザーが予約できないようにします。oAuth を使用して認証する場合...
• cal-com-pp-cli slots update-reserved — Headers セクションに記載されているとおり、cal-api-version ヘッダーの値を必ず渡してください。渡さないと...

stripe — Stripe を管理します

• cal-com-pp-cli stripe check — Stripe 接続を確認します
• cal-com-pp-cli stripe redirect — Stripe 接続 URL を取得します
• cal-com-pp-cli stripe save — Stripe 認証情報を保存します

teams — チームを管理します

• cal-com-pp-cli teams create — OAuth アクセストークンを使用してアクセスする場合、TEAM_PROFILE_WRITE スコープが必要です。
• cal-com-pp-cli teams delete — OAuth アクセストークンを使用してアクセスする場合、TEAM_PROFILE_WRITE スコープが必要です。
• cal-com-pp-cli teams get — OAuth アクセストークンを使用してアクセスする場合、TEAM_PROFILE_READ スコープが必要です。
• cal-com-pp-cli teams get-teamid — OAuth アクセストークンを使用してアクセスする場合、TEAM_PROFILE_READ スコープが必要です。
• cal-com-pp-cli teams update — OAuth アクセストークンを使用してアクセスする場合、TEAM_PROFILE_WRITE スコープが必要です。

verified-resources — 検証済みリソースを管理します

• cal-com-pp-cli verified-resources user-get-verified-email-by-id — OAuth アクセストークンを使用してアクセスする場合、VERIFIED_RESOURCES_READ スコープが必要です。
• cal-com-pp-cli verified-resources user-get-verified-emails — OAuth アクセストークンを使用してアクセスする場合、VERIFIED_RESOURCES_READ スコープが必要です。
• cal-com-pp-cli verified-resources user-get-verified-phone-by-id — OAuth アクセストークンを使用してアクセスする場合、VERIFIED_RESOURCES_READ スコープが必要です。
• cal-com-pp-cli verified-resources user-get-verified-phone-numbers — OAuth アクセストークンを使用してアクセスする場合、VERIFIED_RESOURCES_READ スコープが必要です。
• cal-com-pp-cli verified-resources user-request-email-verification-code — メールアドレスに認証コードを送信します。OAuth アクセストークンを使用してアクセスする場合、VERIFIED_RESOURCES_WRITE...
• cal-com-pp-cli verified-resources user-request-phone-verification-code — 電話番号に認証コードを送信します。OAuth アクセストークンを使用してアクセスする場合、...
• cal-com-pp-cli verified-resources user-verify-email — コードを使用してメールアドレスを認証します。OAuth アクセストークンを使用してアクセスする場合、VERIFIED_RESOURCES_WRITE スコープが必要です。
• cal-com-pp-cli verified-resources user-verify-phone-number — コードを使用して電話番号を認証します。OAuth アクセストークンを使用してアクセスする場合、VERIFIED_RESOURCES_WRITE スコープが...

webhooks — Webhook を管理します

• cal-com-pp-cli webhooks create — OAuth アクセストークンを使用してアクセスする場合、WEBHOOK_WRITE スコープが必要です。
• cal-com-pp-cli webhooks delete — OAuth アクセストークンを使用してアクセスする場合、WEBHOOK_WRITE スコープが必要です。
• cal-com-pp-cli webhooks get — 認証済みユーザーの Webhook のページネーションされたリストを取得します。OAuth アクセストークンを使用してアクセスする場合、...
• cal-com-pp-cli webhooks get-webhookid — OAuth アクセストークンを使用してアクセスする場合、WEBHOOK_READ スコープが必要です。
• cal-com-pp-cli webhooks update — OAuth アクセストークンを使用してアクセスする場合、WEBHOOK_WRITE スコープが必要です。

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

何をしたいかはわかっているが、それを実行するコマンドがわからない場合は、CLI に直接尋ねてください:

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

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

レシピ

予約可能なリンクを作成してその URL を共有する

cal-com-pp-cli link create --slug 30min --length 30 --title "30 Min Meeting"
cal-com-pp-cli link list --json --select links.slug,links.bookable_url

link create は、事前にレンダリングされた予約可能な URL (cal.com//) を返します。link list は、ホストが公開したすべてのリンクのホスト側のビューです。

不在 (out-of-office) に設定する

cal-com-pp-cli ooo set --start 2026-05-12 --end 2026-05-18 --reason vacation --notes "Hawaii trip"
cal-com-pp-cli ooo list --json

OOO エントリが有効な間、Cal.com はその範囲をスロット検索から除外するため、予約されません。

ローカルストアから今日の予定を取得する

cal-com-pp-cli agenda --window today --json --select bookings.uid,bookings.title,bookings.start,bookings.attendees

アジェンダのエンベロープから、エージェントが必要とする 4 つのフィールドだけを返します。深くネストされた予約ペイロードに対してコンテキストを簡潔に保ちます。

開始時刻で並べ替えたイベントタイプ横断のスロット検索

cal-com-pp-cli slots find --event-type-ids 96531 --start tomorrow --end "tomorrow 23:59" --json --first-only

イベントタイプ ID ごとに /v2/slots をファンアウトし、最も早いスロットのみを返します。

キャパシティプランニングのための出席者別ノーショー率

cal-com-pp-cli analytics no-show --window 90d --by attendee --json

同期された予約に対するローカルでの SQL 集計であり、API 呼び出しはありません。

自動化を追加する前に Webhook のカバレッジを監査する

cal-com-pp-cli webhooks coverage --json

登録済みのトリガーを Cal.com の正規のライフサイクルセットと比較し、欠けているサブスクライバーを明らかにします。

予約を次に空いているスロットに再スケジュールする

cal-com-pp-cli reschedule next --uid <booking-uid> --after tomorrow --dry-run

1 つの組み合わせコマンドが 3 つを置き換えます。--dry-run は、確定せずに予定された移動を出力します。

認証のセットアップ

Cal.com は、cal_live_ (ライブ) または cal_test_ (テスト) が先頭に付いたベアラートークンを使用します。環境に CAL_COM_TOKEN を設定するか、auth set-token を一度実行してください。CLI は、マネージドユーザーのアクセストークンと OAuth アクセストークンも同じ Authorization ヘッダーを通じて受け付けます。cal-api-version によるリソースごとの API バージョンピン留めは、クライアントによって自動的に処理されます。

cal-com-pp-cli doctor を実行してセットアップを確認してください。

エージェントモード

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

• パイプ可能 — stdout に JSON、stderr にエラーを出力します

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

  cal-com-pp-cli bookings get --agent --select id,name,status
  

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

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

• 非対話型 — プロンプトは表示されず、すべての入力はフラグで指定します

レスポンスエンベロープ

ローカルストアまたは API からデータを読み取るコマンドは、出力を出所情報のエンベロープで包みます：

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

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照してください。stdout がターミナルの場合に限り、人間が読める N results (live) の概要が stderr に出力されます。パイプ／エージェントから利用する場合、stdout には純粋な JSON のみが出力されます。

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

この CLI に気になる点があった場合は（あなた自身またはエージェントが気づいた場合も）、記録してください：

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

エントリーはローカルの ~/.cal-com-pp-cli/feedback.jsonl に保存されます。CAL_COM_FEEDBACK_ENDPOINT が設定され、かつ --send が渡されるか CAL_COM_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」パターンのように、同じ設定で同じコマンドを毎回実行する場合に使用します。

cal-com-pp-cli profile save briefing --json
cal-com-pp-cli --profile briefing bookings get
cal-com-pp-cli profile list --json
cal-com-pp-cli profile show briefing
cal-com-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します：

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

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

1. MCP サーバーをインストールします：

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

2. Claude Code に登録します：

   claude mcp add cal-com-pp-mcp -- cal-com-pp-mcp
   

3. 確認します：claude mcp list

直接使用

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

   cal-com-pp-cli <command> [subcommand] [args] --agent
   

4. 判断が難しい場合は、サブコマンドのヘルプを確認します：cal-com-pp-cli <command> --help。