take_screenshot
Capture the full screen, a specific app window (even in the background), or a user-selected region as an image. Supports annotations and saves to a file or clipboard.
Instructions
Capture the screen and return the image so it can be looked at. mode 'screen' captures everything (no user interaction); mode 'app' captures one named window and needs no user interaction either — pass 'app' and/or 'title_contains', and it works even when that window is behind others, minimized excepted, without raising it or taking focus; 'region' and 'window' hand the user the native crosshair/window picker and wait for them. Prefer 'app' whenever the user asks about a particular program ("what is playing in Spotify", "read the error in Xcode") — it is the only mode that can see a window the user cannot, and it does not disturb their desktop. Set annotate=true to open Plonk's drawing editor on the capture instead of returning it — use that when the user wants to mark the shot up themselves. Optional 'path' writes to an explicit file, otherwise the configured screenshot folder is used; 'clipboard' overrides the configured copy-to-clipboard behavior. The returned image is scaled down for legibility; the file at 'path' keeps full resolution. To draw on the result, pass that 'path' to annotate_screenshot.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| app | No | mode 'app': app name or bundle id, case-insensitive substring (e.g. 'Spotify') | |
| mode | No | screen | |
| path | No | Explicit output file path (.png) | |
| annotate | No | Open the annotation editor instead of returning the image | |
| clipboard | No | Also copy the capture to the clipboard | |
| include_image | No | Return the image content itself, so it can be inspected (default true) | |
| title_contains | No | mode 'app': narrows to a window whose title contains this, for an app with several |