capture_ui
Screenshots a specified part of Brilliant's UI to an image file, optionally runs commands to set the UI state first, and draws highlight boxes over sub-targets.
Instructions
Screenshot a part of Brilliant's own UI (a toolbar, the palette / color picker, a panel) to an image file. Optionally stage commands to drive the UI into a state first, and draw highlight boxes over sub-targets. target is a capture-registry id such as "full-ui", "top-toolbar", "left-toolbar", "right-toolbar", "bottom-toolbar", "command-palette", or "ai-chat-panel". Chrome only by default on every host (the canvas area is left empty); pass includeCanvas:true (full-ui only) to composite the GPU canvas underneath. Writes lossless WebP by default. Desktop-only: it writes an image file, so it is not available in the web editor.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"target": "<target>",
"outputPath": "<outputPath>"
},
"name": "capture_ui"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cropTo | No | Capture-registry id to crop the result down to. When set, "target" MUST be "full-ui": the full UI is captured (so the panel renders over the real backdrop with true colors), then cropped to this id's on-screen rect. Use this instead of capturing a panel boundary directly, which renders translucent chrome without its backdrop. | |
| format | No | Image format: "webp" (default, lossless) or "png". | |
| target | Yes | Capture-registry id to screenshot (e.g. "command-palette"). REQUIRED. "full-ui" is the whole window: menus, dropdowns, popovers, tooltips and dialogs included (they mount above the panels), so photograph an open menu with target "full-ui" and cropTo its panel; a panel target never contains its own open menu. | |
| settleMs | No | Milliseconds to wait after staging before capturing (default 300). | |
| cropMargin | No | Logical pixels to expand the cropTo rect on all sides (clamped to image bounds). Default 0. | |
| highlights | No | Boxes to draw over the capture. Each is either {target: "<registry-id>"} or {rect: [x, y, w, h]} in captured-image logical pixels. | |
| outputPath | Yes | Absolute file path to write the image to. REQUIRED. | |
| pixelRatio | No | Device-pixel scale for the capture (default 2). | |
| dimBackground | No | Dim everything outside the highlight rects to 35% black. Default false. | |
| includeCanvas | No | Composite the GPU canvas front buffer under the chrome. Only meaningful for target "full-ui". Default false. | |
| stageCommands | No | Ordered commands to drive the UI into the desired state before capturing. Same command IDs execute_commands accepts. Executed sequentially; a failure aborts the capture. |