mvanhorn/printing-press-library

pp-agent-capture

macOS screen capture, window recording, GIF conversion, and agent evidence bundles from the terminal.

ソースを見る

使い方

  1. インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
  2. 必要なツール、認証情報、対応環境を原文で確認します。
  3. 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/mvanhorn/printing-press-library --skill pp-agent-capture

開始前の確認

  • 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

<!-- GENERATED FILE — DO NOT EDIT. This file is a verbatim mirror of library/developer-tools/agent-capture/SKILL.md, regenerated post-merge by tools/generate-skills/. Hand-edits here are silently overwritten on the next regen. Edit the library/ source instead. See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

Agent Capture - Printing Press CLI

Prerequisites: Install the CLI

This skill drives the agent-capture-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

  1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:
bash
   npx -y @mvanhorn/printing-press-library install agent-capture --cli-only
  1. Verify: agent-capture-pp-cli --version
  2. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer):

bash
go install github.com/mvanhorn/printing-press-library/library/developer-tools/agent-capture/cmd/agent-capture-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

When to Use This CLI

Reach for this when the user wants:

  • screenshot a specific window or app (screenshot, batch for multiple)
  • record video of a window, app, display, or region (record)
  • convert a recording to an optimized GIF (convert)
  • do a full capture + record + GIF pipeline in one command (pipeline)
  • diff against a baseline screenshot (diff) for before/after evidence
  • bundle screenshots + recording + GIF as evidence for a PR or bug report (evidence)
  • find the right window by fuzzy-matching its title (find)
  • stitch multiple screenshots into an animated GIF (stitch)
  • extract text from a window using macOS Vision OCR (ocr)
  • record a terminal session via VHS tape files (vhs)
  • render Remotion compositions to video or stills (remotion)
  • monitor a UI by periodic screenshots (watch)
  • save and replay capture configs (preset)

Skip it on non-macOS hosts; the CLI uses ScreenCaptureKit (macOS only). On first run it will prompt for Screen Recording permission; the permissions command guides that flow.

Argument Parsing

Parse $ARGUMENTS:

  1. Empty, `help`, or `--help` -> show agent-capture --help
  2. Starts with `install` -> CLI installation (no MCP server ships today)
  3. Anything else -> Direct Use (map to the best command and run it)

Direct Use

  1. Check installed: which agent-capture. If missing, offer CLI installation.
  2. If permissions aren't granted, run agent-capture permissions first.
  3. Use agent-capture list to see available capture targets (open windows, displays).
  4. Use agent-capture find <text> to fuzzy-match a window title before capturing.
  5. Execute with --json for structured output (agent-native default):
bash
   agent-capture <command> [args] --json

Notable Commands

CommandWhat it does
screenshotCapture a window, app, display, or region
recordRecord video of a window, app, display, or region
pipelineRecord + convert + optimize in one command
convertVideo -> optimized GIF (two-pass palette)
diffCapture + diff against a baseline
evidenceFull bundle (screenshots + recording + GIF) for a PR
batchScreenshot multiple apps in one invocation
findFuzzy search open window titles
listList available capture targets
ocrExtract text from a window using macOS Vision
stitchCombine screenshots into an animated GIF
vhsRun a VHS tape file for terminal recording
remotionRender Remotion compositions
watchPeriodic capture for UI monitoring
presetSave / load capture configs
permissionsGuide Screen Recording permission setup
healthMachine-readable CI / agent preflight

Run any command with --help for full flag documentation.

Exit Codes

CodeMeaning
0Success
2Usage error (wrong arguments)
3Target not found (no matching window or display)
4Permissions missing (Screen Recording not granted)
5Capture error (ScreenCaptureKit failure, ffmpeg failure)
同じリポジトリから

関連する Skills

すべての Skills
mvanhorn
コミュニティ

pp-techmeme

Every Techmeme headline, searchable and cached locally — plus topic tracking, trending analysis, and catch-up workflows no other tool has. Trigger phrases: what's happening in tech, tech news today, check techmeme, what did I miss in tech, trending tech stories, use techmeme, run techmeme.

1時間の導入数
1
GitHub Stars
2142
更新日
11月20日
mvanhorn
コミュニティ

pp-scrape-creators

Every Scrape Creators endpoint across 28 platforms, with credit-aware comment mining and a local corpus no other Scrape Creators tool has. Trigger phrases: find which platforms a creator is on, pull the comments and replies from this post, monitor a brand's ads, search creator transcripts for a keyword, how many credits would this sweep cost, use scrape creators, run scrape-creators.

1時間の導入数
1
GitHub Stars
2107
更新日
11月4日
mvanhorn
コミュニティ

pp-tesla

Every Tesla mobile-app feature, plus a charging-cost ledger and supercharger queue watcher no other Tesla CLI ships. Trigger phrases: is my tesla ready, precondition my tesla, how much did i spend on charging this month, supercharger queue at, send this address to my tesla, list my tesla keys, use tesla, run tesla.

1時間の導入数
1
GitHub Stars
2076
更新日
10月25日
mvanhorn
コミュニティ

pp-flight-goat

Printing Press CLI for Flight Goat. Search real Google Flights fares, cheapest dates, Kayak routes, and FlySoar price checks with no API key — plus optional FlightAware AeroAPI flight status, delay, and alert data.

1時間の導入数
1
GitHub Stars
2076
更新日
10月24日