Goblin User Guide Search⌘K Download
Screenshots & Recording

Editor tasks with Goblin

Coming in the next update

Ask Goblin to crop, annotate, redact or trim an open image or video by naming its document ID, then review and save the result yourself in the editor.

Besides clicking in the annotation editor and the video editor, you can ask Goblin to make edits for you (see GoblinAI settings). Goblin edits locally, one named document at a time, and never saves or uploads anything: you review the export and confirm it in the editor yourself.

Edit an open image by asking Goblin#

  1. Open the screenshot in the editor.
  2. Ask "List Editor Documents". Goblin lists the open editors with a full document ID for each. Goblin never guesses which window you mean from keyboard focus. Closing or replacing a document invalidates its ID.
  3. Ask "Show Editor Status DOCUMENT_ID" to see the current annotation, clip, speed and zoom IDs.
  4. Make the edit, naming the document ID. For a crop: "Set Editor Crop DOCUMENT_ID | 0,0,200,100" (image-coordinate points), review the crop in the editor, then "Apply Editor Crop DOCUMENT_ID".
  5. To save, ask "Review Editor Export DOCUMENT_ID". It opens the existing Save As or Save As Copy dialog. You choose the destination and confirm. "Cancel Editor Review DOCUMENT_ID" closes that review.

After a successful explicit editor command, "this editor" can stand in for its document ID for ten minutes, for example "Show Editor Status this editor". Goblin still checks that the document is open and unchanged in identity. Clearing the conversation clears this context.

Completed exports are not undone. Native Undo remains available for annotations, rotation, zoom, speed and clip order. The canvas, export, palette and mockup settings have no Undo; their replies say so.

Run several commands in one request#

Separate two to five exact editor commands with ; then . Each step needs its document ID or existing explicit context. All commands are checked before starting; the editor checks current state again at each step. Export review must come last. Failure or cancellation stops later steps; completed changes remain and can use native Undo where supported. Other multi-step workflows need separate requests.

What you can ask for#

For an image, you can select a tool, select or delete annotations, set annotation bounds or text, choose the redaction style, and use editor Undo or Redo. To replace text: "Set Annotation Text DOCUMENT_ID | ANNOTATION_ID | replacement text".

Video commands#

For a video, supported commands include seek, play, pause, mute, selecting, splitting, deleting and trimming clips, adding or removing speed and zoom segments, export quality and export audio volume. Use seconds for timeline positions. "Trim Video Clip DOCUMENT_ID | CLIP_ID | 1,5" trims within that clip's current source bounds.

Advanced image edits#

Use a current document UUID from List Editor Documents before every operation. Values after the first | are plain text or a small JSON object; unknown keys, null fields, malformed numbers, unsupported type-specific properties and stale IDs are rejected before any edit.

CommandWhat it does
Inspect Image Annotation document UUID | annotation UUIDReads the current styling, without exposing OCR results or image contents.
Create Image Annotation document UUID | {"tool":"rectangle","bounds":[10,10,80,40]}Adds an annotation. Text also needs text; pencil and highlighter take a bounded path array.
Duplicate Image AnnotationsUses existing annotation UUIDs separated by commas.
Set Image Annotation StyleUses an existing id and the native fields that annotation supports: stroke and fill hex colors, width, text size and presentation, watermark or spotlight options. Text presentation is changed separately so Undo covers the whole edit.
Set Image Annotation GeometryArrow and line endpoints, arrow options, watermark text and text callout tails.
Set Image Counter Options, Set Image Redaction StrengthChange all counters and new ones, or all redactions and the tool default.
Set Image Canvas EffectsA fixed JSON object: background (none, gradient, color or wallpaper, each with its payload), padding, inset, shadow, corners, balancing, alignment, ratio and orientation, and background blur.
Import Image Into EditorInserts an absolute-path image (readable, under 100 MB) into the current document, with the editor's own combine and Undo behavior.
Set Combined Image OptionsLayout mode, direction and gap of an actual combined document.
Set Image Crop OptionsRatio, portrait, grid and edge snapping. Applying a crop is separate.
Set Image Mockup TransformEdits the rotations and perspective, or resets them.
Rotate Editor Imageclockwise or counterclockwise, a native 90-degree rotation.
List Editor Color Palette, Change Editor Color PaletteCustom hex colors and role-specific favorites.
Set Editor Background Cutouton or off.
Read Text From Editor Image, Detect Sensitive Editor RegionsHand the work to the editor's own text reading and redaction scan. They can still be processing: look at the result in the editor before you export, and don't treat the reply as finished OCR or checked redaction.

Advanced video edits#

CommandWhat it does
Set Video Zoom SegmentJSON with an existing id plus optional startTime and duration, level, a normalized center, mode, followSpeed, focusMargin and enabled. Auto mode needs actual recorded mouse data.
Set Video Speed SegmentEdits an existing segment's timing and rate within the gaps on the timeline.
Move Video ClipAn existing id and a zero-based index.
Set Video Zoom Transition0.15 to 0.75 seconds.
Set Video Export OptionsQuality, dimension preset, custom width and height (16 to 8192 pixels), aspect lock, audio mode and the volume of the current audio roles. Unlocking the aspect ratio allows a different width and height. Volumes need Custom Volume mode and current role IDs (mixed, systemAudio, microphone, or an actual additional role). Roles that share one volume can't take conflicting values.
Set Video Background EffectsBackground, padding, shadow and corners.

GIF documents expose dimensions but leave out the video-only audio, zoom and background controls. Save As Copy still needs its own review in the editor. None of these commands saves a file or bypasses an upload or export confirmation.