pp-agent-capture について
pp-agent-captureは、Printing Pressの画面キャプチャCLIを操作するスキルです。スクリーンショットや動画の記録・変換、視覚的な証拠の整理に使えます。ScreenCaptureKitに依存するためmacOS向けです。
主な機能
- 01ウィンドウ、アプリ、画面、領域のキャプチャ
- 02動画の録画とGIF変換
- 03基準スクリーンショットとの比較
- 04報告用の視覚的証拠の一括作成
- 05OCRによるウィンドウ内テキスト抽出
- 06定期キャプチャによるUI監視
活用シーン
- 01不具合報告用にアプリ画面を撮影
- 02変更前後のスクリーンショットを用意
- 03UI操作を録画してGIFに変換
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/pp-agent-captureを入力して読み込まれたか確認します。
詳細
Agent Capture - Printing Press CLI
前提条件：CLI のインストール
このスキルは agent-capture-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**インストールされていない場合は、先にインストールしてください。
- Printing Press のインストーラーを使用してインストールします。バイナリのインストール先は、macOS/Linux では
$HOME/.local/bin、Windows では%LOCALAPPDATA%\Programs\PrintingPress\binがデフォルトです。npx -y @mvanhorn/printing-press-library install agent-capture --cli-only - 確認します：
agent-capture-pp-cli --version - 表示されたインストール先ディレクトリが、このスキルを実行するエージェント／ランタイムの
$PATHに含まれていることを確認します。
npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go で直接インストールしてください（Go 1.26.6 以降が必要です）。
go install github.com/mvanhorn/printing-press-library/library/developer-tools/agent-capture/cmd/agent-capture-pp-cli@latest
インストール後に --version で「command not found」と表示される場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できません。確認に成功するまで、スキルのコマンドを実行しないでください。
この CLI を使う場面
次のような要望がある場合に使用してください。
- 特定のウィンドウまたはアプリのスクリーンショットを撮る（複数の場合は
screenshot、batch） - ウィンドウ、アプリ、ディスプレイ、または領域の動画を録画する（
record） - 録画を最適化された GIF に変換する（
convert） - キャプチャ、録画、GIF 生成のパイプラインを 1 つのコマンドで実行する（
pipeline） - 変更前後の証拠として、ベースラインのスクリーンショットとの差分を取る（
diff） - PR やバグ報告用に、スクリーンショット、録画、GIF を証拠としてまとめる（
evidence） - タイトルをあいまい検索して目的のウィンドウを見つける（
find） - 複数のスクリーンショットをつなぎ合わせてアニメーション GIF を作成する（
stitch） - macOS Vision OCR を使ってウィンドウからテキストを抽出する（
ocr） - VHS テープファイルを使ってターミナルセッションを録画する（
vhs） - Remotion のコンポジションを動画または静止画としてレンダリングする（
remotion） - 定期的なスクリーンショットで UI を監視する（
watch） - キャプチャ設定を保存して再生する（
preset）
macOS 以外のホストでは使用しないでください。この CLI は ScreenCaptureKit を使用しており、macOS 専用です。初回実行時には画面収録の許可を求めるプロンプトが表示されます。permissions コマンドで手順を確認できます。
引数の解析
$ARGUMENTS を解析します。
- 空、
help、または--help->agent-capture --helpを表示します installで始まる場合 -> CLI のインストール（現在、MCP サーバーは提供されていません）- それ以外 -> 直接使用（最適なコマンドに対応付けて実行します）
直接使用
- インストール状況を確認します：
which agent-capture。見つからない場合は、CLI のインストールを案内します。 - 権限が付与されていない場合は、先に
agent-capture permissionsを実行します。 agent-capture listを使って、利用可能なキャプチャ対象（開いているウィンドウ、ディスプレイ）を確認します。- キャプチャ前に
agent-capture find <text>を使って、ウィンドウタイトルをあいまい検索します。 - エージェント向けのデフォルトである構造化出力を得るには、
--jsonを指定して実行します。agent-capture <command> [args] --json
主なコマンド
| コマンド | 機能 |
|---|---|
screenshot | ウィンドウ、アプリ、ディスプレイ、または領域をキャプチャします |
record | ウィンドウ、アプリ、ディスプレイ、または領域の動画を録画します |
pipeline | 1 つのコマンドで録画、変換、最適化を行います |
convert | 動画 -> 最適化された GIF（2 パスのパレット処理） |
diff | キャプチャしてベースラインとの差分を取ります |
evidence | PR 用の一式（スクリーンショット、録画、GIF）をまとめます |
batch | 1 回の実行で複数のアプリのスクリーンショットを撮ります |
find | 開いているウィンドウのタイトルをあいまい検索します |
list | 利用可能なキャプチャ対象を一覧表示します |
ocr | macOS Vision を使ってウィンドウからテキストを抽出します |
stitch | スクリーンショットをつなぎ合わせてアニメーション GIF を作成します |
vhs | ターミナル録画用の VHS テープファイルを実行します |
remotion | Remotion のコンポジションをレンダリングします |
watch | UI 監視用に定期的なキャプチャを行います |
preset | キャプチャ設定を保存／読み込みます |
permissions | 画面収録の権限設定を案内します |
health | CI／エージェントの事前チェックを機械可読形式で実行します |
各コマンドに --help を付けると、フラグの説明をすべて確認できます。
エージェントモード
任意のコマンドに --agent を追加します。次のオプションに展開されます：--json --compact --no-input --no-color --yes。
- パイプ可能 — 標準出力には JSON を出力し、エラーは標準エラー出力に出力します
- フィルタ可能 —
--selectでフィールドの一部を保持できます。ドット区切りパスにも対応しています（以下を参照） - プレビュー可能 —
--dry-runで送信せずにリクエストを表示します - キャッシュ可能 — GET レスポンスは 5 分間キャッシュされます。
--no-cacheでキャッシュを無効にできます - 非対話型 — プロンプトは表示されず、すべての入力はフラグで指定します
出力のフィルタリング
--select では、ネストされたレスポンスをたどるドット区切りパスを指定できます。配列は各要素をたどります：
<cli>-pp-cli <command> --agent --select id,name
<cli>-pp-cli <command> --agent --select items.id,items.owner.name
これを使うと、必要なフィールドだけに大きなペイロードを絞り込めます。深くネストされた API レスポンスでは特に重要です。
終了コード
| コード | 意味 |
|---|---|
| 0 | 成功 |
| 2 | 使用法エラー（引数が正しくありません） |
| 3 | 対象が見つかりません（該当するウィンドウまたはディスプレイがありません） |
| 4 | 権限がありません（画面収録が許可されていません） |
| 5 | キャプチャエラー（ScreenCaptureKit の失敗、ffmpeg の失敗） |