Repository navigation
Releases: davekiss/shot
Releases · davekiss/shot
Release list
v0.1.9
Added
pointtakesuntilfor walking the user through steps:{text: "More tools"}waits for the next step's text to appear somewhere it wasn't when the marks went up,{gone: "Console"}for text to go. The marks show at once, the call blocks for up toseconds(default 60, max 120 withuntil), and it returns with the marks cleared as soon as the step is done. The wait also ends when a marked target leaves its spot, such as a clicked menu item closing. Results carryuntil_met,until_reason,waited_secondsand an image of the window as the wait left it.untilneedsapp,titleorwindow_id.- Annotations accept
x,yfortextandcounteras well asat, andrect: [x, y, w, h]for boxes, instead of failing the call. - Skill: "walk me through it", "show me" and how-to questions about something on screen now use
pointstep by step on the live window instead of a written answer.
Behavior changes
- A new
pointclears marks still showing from the previous one. - Cancelling a call clears its marks right away, and marks go away if the server exits.
- Boxes, loops, highlights and spotlights are placed and drawn before counters and labels, so a counter is never drawn under a box's edge.
composeoutput layers marks in that order.
Full changelog: CHANGELOG.md
v0.1.8
Changed
- Claude Code plugin: new captures and edits appear on a one-row strip above the prompt instead of a toast. It lists the last 3 shots, newest first; clicking one opens it in Preview,
copycopies the newest path, andhidedismisses the strip until the next shot. While the strip is hidden, the prompt's hint line shows a dim▣ N new shots · /shot historyfor 30 minutes.
Removed
- Claude Code plugin: the one-row notice pane and the toast fallback for captures.
Full changelog: CHANGELOG.md
v0.1.7
The first release whose binary is signed with a Developer ID and notarized by Apple, so a browser download opens without a Gatekeeper warning.
Added
captureandrecordtakeephemeral: truefor quick looks. The file goes to a temp folder instead of~/Screenshots, stays out of the library, and is deleted after 10 minutes. Follow-upocr,composeanddiffcalls on it still work in that window, and their outputs stay ephemeral unless given anoutputpath. Results carry"ephemeral": trueanddeleted_after_seconds.SHOT_LIBRARYmoves the screenshot library and its index out of~/Screenshots.
Changed
capture,recordandpointcheck Screen Recording permission first. Without it they return an error with the steps to grant it, instead of a capture with no window contents.- Release binaries are signed and notarized.
Full changelog: CHANGELOG.md
v0.1.6
Fixed
record: GIF frames last until the next frame, and a still ending is kept to the real stop time in the GIF, the MP4 and the reportedduration. macOS only sends frames when the screen changes, so still stretches previously played too fast and endings were cut short.
Full changelog: CHANGELOG.md
v0.1.5
Added
recordfilms a window, a screenregionor the main screen for up to 60secondswithout taking focus, or stops early onuntil({text},{gone}or{stable}). It returns a storyboard:moments, the frames where something visibly changed, each with its time, frame path and changed text, plus a grid image. It saves an MP4, and a GIF withgif: true.
Changed
diffreports the whole lines a change touches intext_beforeandtext_after(Deploying…→Deployed ✓), not just the changed characters.
Fixed
- The plugin launcher now uses a
shotalready onPATH, such as a Homebrew install, instead of downloading a second copy.
Full changelog: CHANGELOG.md
v0.1.4
Added
diffcompares two captures of the same size and returns each changed region with its text before and after, plus an image with the changes boxed and numbered.capturetakeswait_for:{text: "…"}waits for text to appear,{gone: "…"}for it to disappear,{stable: 1}for 1 second with no visible change.timeoutdefaults to 20 seconds, max 120. The result reportswait_met, and on a timeout still returns the last frame.pointdraws marks (arrow, rect, ellipse, line, text, counter, highlight, spotlight) over the live screen for a fewseconds, then fades them. Clicks pass through, focus never moves, nothing is saved. If the window is partly covered, the result includes anote.style: "sketch"draws shapes hand-drawn: loops that overshoot, double-stroked boxes, bowed arrows, highlighter swipes. Set it per call, per annotation, or as a default withSHOT_STYLE. The default style iscrisp.
Changed
- Loops and boxes placed with
targetnever touch the text they mark. In tight spots they use a finer pen. - Mark size scales with the image's text, within a band set by the image size.
Full changelog: CHANGELOG.md
v0.1.3
Added
- Type styles for labels and counters, set with
font:pixel(Departure Mono, embedded, the default),clean,rounded,serif,mono, or an installed font name.SHOT_FONTsets the default. cropaccepts a list of targets to frame several lines.
Changed
- Marks draw in adaptive ink: near-black with a white halo on light areas, near-white with a dark halo on dark areas. An explicit
colorkeeps its hue. - Marks avoid each other as well as the screenshot's text. Callout labels sit at the arrow's tail, and counters sit beside their text.
Behavior changes
composeredacts sensitive text by default. Passredact_sensitive: falseto keep it visible.- The default mark color changed from purple
#7C5CFFto adaptive ink.
Full changelog: CHANGELOG.md
v0.1.2
Fixed
- Redaction covers the password in connection URLs (
scheme://user:password@host) and leaves the host readable. - Redaction boxes no longer clip the character before a value.
Full changelog: CHANGELOG.md
v0.1.1
Added
- Install instructions for Codex, OpenCode and Cursor, and a Homebrew tap:
brew install davekiss/tap/shot. - Release archives include the skill, so other agents can install it from
~/.agents/skills.
Changed
- The Claude Code marketplace is named
davekiss. Install with/plugin install shot@davekiss.
Full changelog: CHANGELOG.md
v0.1.0
First public release: a macOS MCP server with capture, compose (with target), ocr, find_sensitive, find_shots, list_windows and annotate, plus a Claude Code plugin with a skill, /shot and a history pane.
Full changelog: CHANGELOG.md