pp-delta-trip

Delta Trip — Printing Press CLI

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

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

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

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

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

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

go install github.com/mvanhorn/printing-press-library/library/travel/delta-trip/cmd/delta-trip-pp-cli@latest

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

この CLI を使用しない場合

リモート状態の作成、更新、削除、公開、コメント、賛成投票、招待、注文、メッセージ送信、予約、購入、変更を必要とするリクエストでは、この CLI を有効にしないでください。この印刷用 CLI が公開するのは、確認、エクスポート、同期、分析のための読み取り専用コマンドです。

HTTP トランスポート

この CLI は、ブラウザー向けエンドポイントに Chrome 互換の HTTP トランスポートを使用します。通常の API 呼び出しに常駐ブラウザープロセスは必要ありません。

コマンドリファレンス

baggage — 旅行の手荷物情報と追跡

• delta-trip-pp-cli baggage — 予約確認情報の手荷物許容量と追跡情報を表示します

flights — 旅行のフライト詳細 — 出発、到着、座席、運賃クラス、運航会社

• delta-trip-pp-cli flights — 旅程内のすべてのフライトを詳細とともに一覧表示します

seats — フライトごとの乗客別の座席割り当てとアップグレード資格

• delta-trip-pp-cli seats — すべての乗客の座席割り当てとアップグレードオプションを表示します

trips — 予約確認番号による Delta の旅行の検索と管理

• delta-trip-pp-cli trips — 予約確認番号、名、姓を指定して旅行を検索します

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

実行したいことはわかっていても、どのコマンドを使えばよいかわからない場合は、CLI に直接問い合わせてください。

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

which は、自然言語による機能の問い合わせを、この CLI の厳選された機能インデックスから最も適切なコマンドに対応付けます。終了コード 0 は少なくとも 1 件の一致を意味します。終了コード 2 は確度の高い一致がないことを意味するため、--help に切り替えるか、より絞り込んだ問い合わせを使用してください。

認証の設定

認証は不要です。

delta-trip-pp-cli doctor を実行して、セットアップを確認します。

エージェントモード

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

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

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

  delta-trip-pp-cli flights --confirmation example-value --first-name example-resource --last-name example-resource --agent --select id,name,status
  

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

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

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

• 読み取り専用 — 作成、更新、削除、公開、コメント、賛成投票、招待、注文、送信、その他の変更を伴うリクエストには、この CLI を使用しないでください

レスポンスエンベロープ

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

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

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照してください。人が読める N results (live) の概要は、stdout がターミナルで、かつ機械可読形式のフラグ（--json、--csv、--compact、--quiet、--plain、--select）が設定されていない場合にのみ stderr に出力されます。パイプ経由／エージェントによる利用や明示的な形式指定で実行した場合、stdout には JSON のみが出力されます。

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

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

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

記録は ~/.delta-trip-pp-cli/feedback.jsonl にローカル保存されます。DELTA_TRIP_FEEDBACK_ENDPOINT が設定されており、かつ --send が渡されているか、DELTA_TRIP_FEEDBACK_AUTO_SEND=true が設定されていない限り、POST されることはありません。デフォルトの動作はローカル保存のみです。

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

出力の配信

すべてのコマンドで --deliver <sink> を指定できます。出力は stdout に加えて（または stdout の代わりに）指定した sink に送られるため、エージェントはコマンドの結果を手作業でパイプに渡さずに振り分けられます。対応している sink は 3 種類です。

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

不明なスキームは、対応しているスキームの一覧を含む構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の値を返し、stderr に URL と HTTP ステータスを出力します。

名前付きプロファイル

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

delta-trip-pp-cli profile save briefing --json
delta-trip-pp-cli --profile briefing flights --confirmation example-value --first-name example-resource --last-name example-resource
delta-trip-pp-cli profile list --json
delta-trip-pp-cli profile show briefing
delta-trip-pp-cli profile delete briefing --yes

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

終了コード

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

引数の解析

$ARGUMENTS を解析します。

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

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

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

claude mcp add delta-trip-pp-mcp -- delta-trip-pp-mcp

確認します：claude mcp list

直接使用

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

   delta-trip-pp-cli <command> [subcommand] [args] --agent
   

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