mvanhorn/printing-press-library

pp-agent-capture

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

Quelltext ansehen

Verwendung

  1. Installationsbefehl kopieren und das Quellpaket vor der Installation in der eigenen Agentenumgebung prüfen.
  2. Benötigte Werkzeuge, Zugangsdaten und Hosts im Original prüfen.
  3. Eingabe und gewünschtes Ergebnis beschreiben und die Ausgabe mit den Quellen abgleichen.
npx skills add https://github.com/mvanhorn/printing-press-library --skill pp-agent-capture

Vor dem Start

  • Die Installation umfasst weder Modellabo noch API-Kontingent oder Dateizugriffsrechte.
  • Sterne und Installationen zeigen Aktivität, keine unabhängige Qualitäts- oder Sicherheitsprüfung.
Originales Skill-Dokument

Aus dem Quell-Repository gerendert; Überschriften, Beispiele, Code, Tabellen, Links und Bilder bleiben erhalten.

<!-- 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)
aus demselben Repository

Weitere Skills

Alle Skills
mvanhorn
Community

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.

Installationen / 1h
1
GitHub Stars
2142
Aktualisiert
20. Nov.
mvanhorn
Community

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.

Installationen / 1h
1
GitHub Stars
2107
Aktualisiert
4. Nov.
mvanhorn
Community

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.

Installationen / 1h
1
GitHub Stars
2076
Aktualisiert
25. Okt.
mvanhorn
Community

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.

Installationen / 1h
1
GitHub Stars
2076
Aktualisiert
24. Okt.