Quilltap 4.2.2

Quilltap 4.2.2 Release Notes

The art of correspondence, as any society hostess will tell you, depends entirely upon the letter arriving in a form the recipient can actually open. You may compose the most exquisite invitation — embossed, perfumed, sealed with your finest wax — but if you deliver it in a language the butler doesn't speak, you will spend the evening alone with the canapes.

The image clipboard system suffered from precisely this variety of social catastrophe. When one admired an image in the fullscreen viewer — a story background, a generated portrait, a tool result — and pressed the Copy button with the intention of pasting it into the Chat Composer, the image dutifully climbed onto the clipboard. The trouble was how it climbed. Under Electron, the copy operation took the scenic route through the main process, where Electron's native clipboard.writeImage() deposited the image onto the OS clipboard as a proper native bitmap. Excellent for pasting into external applications. Absolutely useless for pasting back into the same Electron window, because Chromium's renderer process — the very room from which the image had just departed — did not recognize the returning guest. The paste handler checked the clipboard for items of type image/*, found nothing it could parse, and politely ignored the whole affair.

The image had been copied. The image was on the clipboard. The image could not be pasted. It was the conversational equivalent of sending a telegram to the person sitting across the table.

The fix reverses the order of operations. Rather than immediately dispatching the image through Electron's native postal service, the clipboard utility now tries the standard browser Clipboard API first — navigator.clipboard.write() with a proper PNG ClipboardItem. In modern Chromium (which is to say, every Electron version shipped in the past two years), this works beautifully, and the resulting clipboard data is immediately legible to the same renderer that wrote it. Copy from the viewer, paste into the Composer, and the image arrives without needing an interpreter.

Should the browser API fail — older Electron builds, unusual permission configurations, the sort of edge case that keeps engineers awake — the native IPC path remains as a fallback. External applications can still receive their clipboard images. But the common case, the one where you copy an image and paste it ten seconds later in the same window, now works as it always should have.

---

What Changed

• fix: Image copy button in fullscreen viewers (gallery, image modal, tool messages) produced clipboard data that couldn't be pasted back into the ChatComposer under Electron. Now prefers the standard Clipboard API for in-app round-trip compatibility, falling back to Electron IPC for external-app interop.

---

Installation

Desktop App

Download from the quilltap-shell releases page:

macOS:

1. Download the .dmg file and open it
2. Drag Quilltap to your Applications folder
3. Launch Quilltap from Applications

Windows:

1. Download and run the .exe installer
2. If SmartScreen warns about an unknown publisher, click "More info" → "Run anyway"
3. Launch Quilltap from the Start Menu or desktop shortcut

Linux:

1. Download the .AppImage file, make it executable (chmod +x), and run it
2. Or install the .deb package: sudo dpkg -i quilltap_*.deb

Node.js (any platform)

npx quilltap

Or install globally:

npm install -g quilltap
quilltap

Open http://localhost:3000 in your browser. Requires Node.js 22+. First run downloads ~150-250 MB and caches locally.

Docker

docker pull foundry9/quilltap:4.2.2

Or use the startup scripts:

# Linux / macOS
curl -fsSL https://raw.githubusercontent.com/foundry-9/quilltap-server/refs/heads/main/scripts/start-quilltap.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/foundry-9/quilltap-server/refs/heads/main/scripts/start-quilltap.ps1 | iex

---

One does not blame the butler for refusing an envelope he cannot open. One simply writes the address in a language he reads.

-- The Foundry, with improved penmanship

Installation

Desktop App (recommended)

The Quilltap desktop app (Electron) is available from
quilltap-shell 4.1.0.
Download the release for your platform (macOS, Windows, or Linux).

The quilltap-linux-arm64.tar.gz and quilltap-linux-amd64.tar.gz rootfs
tarballs attached to this release are used by the shell's Lima (macOS) and WSL2 (Windows) VM modes.

Node.js (any platform)

npm install -g quilltap
quilltap

On first run, the CLI downloads the application files (~150-250 MB)
and caches them locally. Subsequent launches start instantly.

Docker

docker pull foundry9/quilltap:4.2.2

See the README for setup instructions.