| name | seer |
| description | Visual feedback capture for any running macOS app window via osascript + screencapture. Use when the user wants UI verification or a fresh screenshot. |
Seer
Overview
Grab a precise screenshot of a visible app window and attach it for visual iteration.
Quick start
- Ensure the target app is running and Screen Recording + Accessibility are enabled for your terminal.
- Run the script:
bash scripts/capture_app_window.sh(defaults to frontmost app, output/tmp/seer/app-window-shot-YYYYMMDD-HHMMSS-<pid>-<rand>.png)bash scripts/capture_app_window.sh /path/to/out.png "Promptlight"(custom output + process name)
- Attach the image with
view_image.
Usage
bash scripts/capture_app_window.sh --helpbash scripts/capture_app_window.sh [out_path] [process_name]out_pathdefault/tmp/seer/app-window-shot-YYYYMMDD-HHMMSS-<pid>-<rand>.pngprocess_namedefault frontmost app- set
SEER_TMP_DIRto change default output dir
Workflow
- Capture
scripts/capture_app_window.sh- If it fails, rerun with explicit process name or verify permissions.
- Inspect
- Use
view_imageto load the output.
- Use
- Iterate
- Repeat after UI changes or window repositioning.
Resources
scripts/
capture_app_window.sh: grabs window bounds via System Events and runsscreencapture -x -R.