hold

Reviewed at commit a583556 New version, not yet reviewed

Comprehension at the human's pace. Grasp a change, drive a behavior, land one thing in an audience — until you can say how it works with the agent out of the…

Made by
Saad Shahd
What we checked

Draws Mermaid diagrams in Claude's replies as pictures and adds a view button to tool rows that read or changed an image, using bun, which you need installed, to render PNGs into a temp folder. On macOS or Linux desktops it can show a picture in a small window that closes on a click or after two minutes. Also adds four learning skills and an optional Plain output style; nothing leaves your machine.

Review details

Static review of the source at the pinned commit; not run. hooks.json loads view.tsx, which registers session.end (closes any open picture window), config.set for key theme (re-reads the theme) and ui.render for AssistantMessage, ToolUse and ToolGroup. For a reply with a closed ```mermaid fence it hashes the source and runs $.process.run(['bun', <plugin>/draw/draw.ts, 'mermaid', theme, out]) with the source on stdin (30 s timeout), then reads the PNG back with $.fs.read and shows it with the Image element when the terminal can draw pixels (decided from TERM_PROGRAM, TERM, KITTY_WINDOW_ID, TMUX, ROUNDUP_TERMINAL and CLAUDE_CODE_FORCE_TERMINAL_IMAGES via $.env.get), otherwise as a text line with an open button. For finished Read, Write, Edit, MultiEdit and Bash calls it lists touched .png/.jpg/.gif/.svg paths from the tool input and output and adds a view/fold button; only a press runs $.fs.stat and draw.ts 'picture' on that file. draw.ts (bun) reads the picture or Mermaid source and system font files from fixed /System/Library/Fonts and /usr/share/fonts paths, renders with the vendored pele.js (minified bundle of the pinned npm package pele 1.13.0, Mermaid parser and SVG renderer) and resvg.js plus the prebuilt resvg.wasm (wasm-bindgen glue for @resvg/resvg-wasm 2.6.2, initialised from the local file so its fetch branch is not reached; its imports give the WebAssembly no file or network access), and writes the PNG to $TMPDIR/moo-hold-view/<hash>.png (default /tmp), which is not cleaned up. Window mode (popover.ts, window.ts): skipped over SSH; runs uname -s, on Linux checks DISPLAY and python3 -c 'import tkinter'; on a press reads the pointer position with osascript JXA or python3 Tk, runs pkill -f moo-hold-view-window (its own marker only) and spawns an osascript AppKit panel or python3 Tk window with the PNG path in its environment; the window exits on a click, when the parent exits, when nobody reads its output or after 120 s. Other runtime calls: $.config.list (theme only), $.ui.resolve, $.ui.invalidate, $.ui.toast for one-line failure messages, $.clock.sleep, $.plugin.root; failures fall back to the normal rendering. No network calls, no settings writes, no tool-call or permission changes. Prompts: skills grasp, land, toy and learn have Claude build an HTML page outside the repo and open it with open <path> (normal permission prompts, no allowed-tools); output style hold:Plain changes reply format only when selected and is disclosed in the repository README. Read fully: manifests, view.tsx, fences.ts, files.ts, terminal.ts, popover.ts, ui.ts, window.ts, draw.ts, resvg.js init path, prompts; size.ts, svg.ts and theme.ts skimmed and grepped; the 718 KB minified pele.js (truncated in the bundle) checked in the clone by targeted search (no fetch, XHR, sockets, eval, new Function, imports, Bun or process use; only an export of render). resvg.wasm is a binary and was not inspected; bun itself is an external program and was not reviewed.

What it uses
  • Reads your prompts: no
  • Sees tool calls: yes
  • Blocks or changes tool calls: no
  • Reads or writes files: yes
  • Runs programs on your machine: yes
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: no
  • Shows something on screen: yes
Hooked events
Screenshot of hold

Comprehension at the human's pace. Grasp a change, drive a behavior, land one thing in an audience — until you can say how it works with the agent out of the room. A reply's Mermaid diagrams draw as pictures, and the pictures Claude touches open in place.

Made this mod? Add a badge to your README

modsforClaude badge for hold

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/hold.svg)](https://modsforclaude.com/mods/hold/)

← All mods