Skip to content

Quilltap 4.1.1

Choose a tag to compare

@csebold csebold released this 07 Apr 14:34
· 2544 commits to main since this release

Quilltap 4.1.1 Release Notes

There is a certain kind of amnesia peculiar to the overly efficient secretary — the sort who, upon transcribing the minutes of last Tuesday's board meeting, dates every page with today's date, on the grounds that today is when the transcription occurred. The facts are all present and correct. The context, however, has been quietly murdered.

The Commonplace Book's memory extraction suffered from this very affliction. When a character's memories were extracted from conversation — whether in real-time as messages arrived or in batch during a re-extraction — each memory was stamped with the moment of its extraction rather than the moment of its origin. A memory drawn from a conversation held last Wednesday would claim, with perfect confidence, to have been born this morning. This made chronological reasoning about a character's knowledge rather like trying to reconstruct a timeline from a filing cabinet where every folder is labelled "today."

The fix ensures that extracted memories now carry the timestamp of their source message — the moment the words were actually spoken, not the moment someone got around to filing them. A one-time migration runs on startup to backfill existing memories from their linked source messages, correcting any temporal irregularities accumulated thus far.

Your characters' memories now know not merely what was said, but when.


What Changed

  • fix: Memory extraction (both batch and real-time) now preserves the source message's createdAt as the memory's createdAt/updatedAt instead of using the extraction time
  • fix: One-time migration backfills existing memories with correct timestamps from their linked source messages

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.1.1

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

The filing cabinet has been re-dated. The secretary sends her apologies.

— The Commonplace Book, temporally corrected

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.1.1

See the README for setup instructions.