Why does Playbill ask for Screen Recording permission?
Playbill photographs your app's windows to make screenshots. macOS requires the Screen Recording permission for that. The grant goes to Playbill itself, a single-purpose app whose library shows you exactly what it captured, rather than to your terminal, which would extend the permission to everything your terminal runs.
Where are my images stored?
In your Playbill Library, a folder in your iCloud Drive. They're ordinary PNG files, synced by iCloud to your Macs, visible in Files on iPhone and iPad. Nothing is uploaded to us; we never see your images.
The permission card keeps showing even though I granted access
macOS ties permissions to an app's code signature. If you've rebuilt or reinstalled Playbill from source, remove the stale "Playbill" row in System Settings → Privacy & Security → Screen & System Audio Recording, then grant again from the app.
A capture came out black or empty
Grant Screen Recording (see above), make sure the target app's window is on screen and not minimized, and try again: the first capture after granting can fail transiently; a second attempt succeeds.
Does Playbill work in CI?
The rendering pipeline runs headless with no permissions. Window capture on CI is on the roadmap via simulator capture (iOS) and self-rendering demo modes (macOS).