Changelog

What changed in each release, newest first. “Unreleased” is what the next release will contain. The source is CHANGELOG.md.

0.2.3

v0.2.3 on GitHub

Lyric motion several times faster, and pasting that stays out of the way.

Improved

  • Quiet pasting — the shortcuts (and Paste as…) no longer pop a card in the top-right corner. While a result is being made, a small breathing dot sits right after your text cursor (next to the pointer in apps that do not report a cursor, such as terminals and some web editors); press Esc to cancel. When the result is pasted the dot just fades; nothing else appears. Anything worth reading (an error, a note) is a one-line bubble at the cursor that fades by itself. The card is kept only for when you have to act: Accessibility is missing, or a password field stopped the paste. To switch a result's style afterwards, open clipboard history (⇧⌥V), which shows the latest result. Reduce Motion keeps the dot still.
  • No pasting into the wrong app — if you switch apps while a result is being made, it is copied instead of pasted, with "Copied. Press ⌘V where you want it."
  • Faster Lyric motion — videos and GIFs render several times faster: frames are drawn on several cores at once, and a frame that repeats the one before it is not drawn again. A 30-second video takes about 5–8 seconds instead of 20–30 on a Mac mini M4, with exactly the same pictures. Other animated GIFs and videos are faster too.
  • Faster Japanese — cards, GIFs and videos of Japanese text are ready 3–4 seconds sooner: kana, the common kanji and marks such as 「」『』・〜 (and full-width letters and digits) no longer need a measuring pass of their own.

Fixed

  • Lyric motion in 16:9 — most Lyric motion GIFs and videos in the 16:9 frame failed with an internal font error; they render again, in every style.
  • Lyric motion, Paper, Japanese — a line with a comma set in a vertical column at the right edge (such as 「ねえ、」) no longer stops the whole video with "does not fit its canvas"; and if a composition ever does not fit a screen, another one is used for that screen instead of failing the video.

0.2.2

v0.2.2 on GitHub

Lyric motion for any text, redrawn in four styles, and video with nothing to install.

New

  • Lyric motion (文字 PV) — the lyrics template becomes Lyric motion and works on any text, not only lyrics: press L in Paste as… (⌥V) for kinetic type of whatever you copied. Prose is cut into screens at its sentences and clauses (never mid-word), held long enough to read; lyrics, poems and LRC keep their own lines. It makes a GIF by default, or a video or a poster (see the next item). It is never chosen automatically any more, so copied lyrics and poems now come out as text or document cards unless you ask; switch any result to Lyric motion from its template menu, or give it its own shortcut in Settings › Shortcuts. Code, tables and very long text get a clear message instead of a video.
  • Lyric motion's output — Settings › Templates › Lyric motion › Default output: GIF (the default), Video or Poster (PNG). The chooser row says which ("Lyric motion · GIF"), and a result's format menu still switches one result. Text too long for a GIF (about 14 seconds) says so and suggests Video instead of switching silently.
  • Video without ffmpeg — MP4 is now encoded by Peesuto itself with the Mac's hardware H.264 encoder (AVFoundation and VideoToolbox), so Video (M) and Lyric motion videos work out of the box, with nothing to install. The encoder is more than twice as fast as the ffmpeg pass it replaces, the file opens progressively (moov first), and colours now match the image cards in QuickTime, Safari and Messages (BT.709, tagged sRGB; ffmpeg's untagged output shifted saturated reds and lifted greys). ffmpeg is no longer used by the app; bun run paste outside the app still falls back to it.

Improved

  • Lyric motion, redrawn — four styles instead of two: Stage (heavy 得意黑 / Dela Gothic / Anton type, colour cuts on black, red, cobalt and yellow), Paper (霞鹜文楷 / Kaisei Tokumin / Instrument Serif, vertical CJK, hairlines, a vermilion seal), Pop (站酷快乐体 / Zen Maru Gothic, candy colours, stickers, bouncy motion) and Night (DotGothic16 / 得意黑, colour ghosts, glitch cuts, scanlines, a camera HUD). Each cut now picks one of 22 compositions (a giant word filling the frame, words stacked at jumping sizes, a tilted band, split colour fields, hollow ghost repeats, word plates, tickers, a big number, an editorial corner caption and more), lines land in two or three hits, Pop and Night move on twos like anime (12 drawings a second), cut lengths follow a beat, and fine film grain lies over the picture. Words larger than before are drawn by Peesuto itself, so a short line can fill the screen. The text is still drawn exactly once, readable and in high contrast; the display fonts (OFL, about 13 MB) ship with the app.
  • Arrow keys in Paste as… — ↑ and ↓ (and Tab, Home, End) move the highlight in the ⌥V chooser, skipping rows that do not apply, and Return runs the highlighted row. It starts on Image, so Return alone still pastes an image; the letter keys still run their row at once, and the pointer moves the highlight too.
  • Lyrics with paint — in lyric posters and videos, emphasised words now shine: gold gradient ink with a soft glow in the Stage style, a heavier vermilion in Paper; letters come into focus as they appear, and Stage's big disc is a soft light.
  • Finer code and terminal backdrops — the Indigo night colour field behind code and terminal cards is now drawn at the card's full resolution with its full grain, instead of a small texture stretched to fit; the faint diagonal weave in its gradients is gone.

0.2.1

v0.2.1 on GitHub

Six new templates, and a lighter app.

New

  • Lyrics cards — song lyrics, LRC files and classical poems become a lyric poster (PNG) or a short kinetic-type lyric video (GIF/MP4): a cut per line with staggered letters, colour changes, moving decor, emphasis that punches; JIZURA's /, *emphasis*, |note and ! markup works. "Open in JIZURA" hands the lyrics to JIZURA for a full lyric video.
  • Metrics cards — several label: number lines, with changes such as (+8%), become a grid of big numbers; rises are green, falls red.
  • Schedule cards — agendas, itineraries and roadmaps (lines that start with a time or a date) become a timeline with a dot per event.
  • Error cards — a copied error with its stack trace (JavaScript, Python, Java, C#, Go, Rust, Ruby, PHP) leads with the message; your own frames stand out, library frames are dimmed.
  • Diff cards — a copied git diff or patch becomes a review card: file names as titles, added and removed lines on green and red rows, and a +N −M count. A git show or git format-patch header (sha, author, date, message) sits above it as written.
  • Terminal session cards — a copied shell session becomes a terminal window: prompts and commands stand out, output is dimmed, errors are red and a final exit status sits in a pill.

Improved

  • A smaller download — the app is about 45 MB smaller (the DMG about 11 MB), with every template still rendered offline.
  • Install with Homebrew — brew install --cask anelikes/tap/peesuto.

0.2.0

v0.2.0 on GitHub

The first public release.

New

  • Paste as… — press ⌥V while typing anywhere: a small chooser opens at the caret with a preview of the card. Return pastes an image; G, M, Q and P paste a GIF, a video, a QR code or pin it to the screen; H opens the clipboard history (⇧⌥V). Every output can also have its own shortcut in Settings › Shortcuts.
  • Automatic updates — Peesuto checks for new versions once a day (Settings › General).
  • Info cards — contacts, accounts, server settings and .env blocks become a tidy card of fields: phone numbers spaced, links and emails styled, passwords and keys marked, icons where a line has no label.
  • Release notes cards — copied release notes become a card with the version up front and tagged sections.
  • Signature — an optional line such as "@you · example.com" at the bottom of every card (Settings › Templates).
  • Templates in Settings — every template with its styles; turn templates off for automatic choice, pick a default style, choose the card font.
  • Japanese — the interface is available in Japanese, and Japanese text renders on cards.
  • Your own AI key, optional — Jev via TypeSafe, Vercel AI Gateway, OpenRouter or Cloudflare for smarter suggestions; nothing is needed to use Peesuto.

Cards

  • Cards are set in Maple Mono, with a proportional cut for Chinese and Japanese text; keyboard symbols such as ⌘ and ⌥ render.
  • Code cards: real syntax highlighting, line numbers, and a soft "Indigo night" backdrop.
  • Readable on a phone: no text smaller than a phone's footnote size when a card is shared.
  • Quieter templates: decorative marks that meant nothing are gone, and colours meet contrast guidelines.
  • Words are never split across lines, and every card is checked before it is drawn: if anything you copied would be missing, Peesuto says so instead of pasting an incomplete card.

App

  • A new three-step welcome guide.
  • The clipboard panel sits on glass, hides as soon as you click elsewhere, and can be pinned open.
  • Clearer help when Accessibility is on in System Settings but not taking effect.

Open source

  • Peesuto is MIT-licensed and developed in the open at github.com/anelikes/peesuto.

0.1.1

v0.1.1 on GitHub

First signed and notarized native release (Apple silicon, macOS 13+).

  • Media shortcuts always paste into the frontmost app (no more "copied, press ⌘V" after a focus check); only missing Accessibility, secure input or Peesuto in front fall back to copy, with the reason and a button to grant access.
  • Prepare on copy moved next to the paste shortcuts; new installs pre-render images by default, with local rules only.
  • First-run welcome guide (what Peesuto does, shortcuts, permissions and privacy including the Keychain prompt, preferences, a try-it step), reopenable from Settings › General › About.
  • Box-drawing tables (Unicode, rounded, ASCII, psql) copied from terminals become tables; wrapped cells are joined. Mixed Latin and Chinese lines break between Chinese words instead of stranding a word before a space.
  • Template redesign (with Claude Design): one neutral paper and night plus a signature colour per template; every template reads a style table; short content grows a type step and is centred in fixed frames; code gets light syntax colouring; added labels (NOTES, 01, CODE, line numbers) are gone; quote marks and author dashes are shapes, not glyphs. Diagram ports spread over a node side and edge labels avoid nodes, lines and each other.
  • QR code: paste-qr (⌘⌥4) encodes the copied text exactly as a QR code, in two styles, with a caption for one short line; never chosen automatically and never sent to a model; too-long text is an explicit error.
  • Fix: the app bundle now ships core's own packages (gifenc, qrcode-generator) and Core runs with --no-install. Installed outside the repository, GIF rendering failed offline and Bun would otherwise have fetched the package from npm at runtime, outside the egress layer. The bundler proves offline resolution from a copy outside the repository.
  • Precompose (off by default): each copied text is rendered in the background as an image, GIF and/or video, so the paste shortcut returns it at once; local rules decide unless the model is allowed; texts with secrets, long texts, Low Power Mode and busy moments are skipped; a new copy cancels older work, an explicit action preempts it.
  • What an AI model sees is now controlled: raw, sensitive details redacted (default) or structure only. Built-in rules catch API keys, private keys, JWTs, bearer tokens, credentials in URLs, secret assignments and random-looking tokens; email, phone, ID card and bank card rules exist but are off. Custom rules (text, keywords or regex) replace matches with the user's text, optionally in the rendered output too. The model still only picks presentation; content is rendered locally. Settings, Privacy & Precompose; Studio shows what the model receives.
  • Frames: images fit their content by default (width by content, height hugging it above a per-template minimum); GIF and video keep a strict fixed frame (1:1 by default, also 4:5, 16:9, 9:16) and scroll tall content. The native app has an image, GIF and video frame setting and a per-result frame menu; meta.template.aspect reports the frame used.
  • Studio (bun run studio): a local page that decides and renders clipboard scenarios or any pasted text in every template, style, motion and format, with a cache keyed by the template code so edited style tokens re-render on reload; links per scenario (#<id>); the static gallery reuses it.
  • Diagram template: Mermaid flowcharts (fenced or bare) and plain arrow chains become a layered node diagram in two styles (Flow, Blueprint), with decision diamonds, edge labels, dotted and thick links, cycles, and a rank-by-rank reveal.
  • Mixed Chinese and Latin lines no longer break at a far-back space ("第 1" alone on a line); scripts/gallery.ts renders a preview page of realistic scenarios in every template, style, motion and format.
  • Tall GIF/MP4 content scrolls through a fixed canvas (still start, eased scroll at reading speed, still end) instead of growing or failing; PNG still grows.
  • Messages copied out of chat apps (speaker, timestamp, message) render as a conversation, with the time kept as small text.
  • Invisible characters chat apps insert (U+2005 after a WeChat @mention, zero-width spaces) no longer make a card fail with "could not fit"; layout errors now say which character the font cannot draw, or that there is nothing to render.
  • Text template, the default for short plain prose: typography alone in three styles (Paper, Ink, Poster), size by length, balanced and vertically centered lines, and an optional accent on one source word chosen by the model. Styles are a token table for redesign.
  • All templates: lines break at word boundaries in Chinese and Japanese too, and closing punctuation no longer starts a line.
  • Native app: saving settings during a render no longer restarts Core (the config waits for the task); action timeouts are 300 s for image/GIF and 720 s for video; Core's death fails pending requests at once and its process group is always killed; the last Core stderr lines show in errors and in Settings → Core diagnostics.
  • Native app: a locked history keeps capturing in memory and offers "Start fresh"; Clear history; Open at login; decider errors show as a note on the result; the app no longer records its own pasteboard writes.
  • GIF and video actions can no longer come out as a single still frame: "none" is not offered as motion when an action needs motion, an override of it falls back to "reveal", and a one-frame GIF/MP4 is an error.
  • Over-long text is refused before any model call or layout; wrapping is linear.
  • Renders have a deadline (240 s image/GIF, 600 s MP4, PASTE_RENDER_TIMEOUT_MS); a hung engine or ffmpeg process group is killed.
  • Generated files in the cards directory are pruned after each render (older than 24 h or beyond the newest 30).
  • A failed decider still renders with the fallback, and the error now comes back as decisionError in the action result.
  • A failed render never deletes a caller's existing file; the daemon answers an unknown cmd with a usage error carrying the request id.
  • Minimum macOS is now 13.0 (the bundled Bun requires it); builds are arm64 only. CI's macOS jobs moved to macos-15 with Xcode 16.4 selected explicitly.
  • Removed the legacy desktop source, UI build dependencies and tag-triggered release workflow. native/ is now the only desktop entry point; CI builds/tests the native app and bundled Core. Manual workflow artifacts are validation builds only; native signing, notarization, updating and missing management UI remain unfinished.
  • Native media shortcuts: configurable ⌘⌥1 image, ⌘⌥2 GIF and ⌘⌥3 video operate on copied text without opening history. Includes a key recorder, conflict rollback, task status window and conservative automatic paste with focus/clipboard guards. Added the paste-video MP4 action (requires locally installed ffmpeg), native video playback, unique result files and opt-in Core lifecycle events; active tasks no longer trigger the daemon idle timeout.
  • First SwiftUI + AppKit desktop implementation in native/, retaining Bun Core and Pocket Motion without a UI WebView. Includes native history/results/settings, English and Simplified Chinese, compatible encrypted storage/Keychain, system integration, a process-safe Core client and actual .app build/smoke commands. Full desktop migration and release cutover remain incomplete.
  • Recorded the native architecture decision: SwiftUI + AppKit replaces the retired desktop while retaining Bun Core and Pocket Motion. Image/GIF/video generation is a core product capability. The migration plan includes data compatibility, task lifecycle, a simpler bilingual GUI and actual .app acceptance; the first native implementation is now available; complete migration remains unfinished.
  • English and Simplified Chinese UI, with a language selector in Settings → General (system default). User content and custom action names stay unchanged.
  • The app is called Peesuto. The identifier is com.peesuto.desktop; the repository and internal paths keep the name pocket-paste.
  • Cloudflare decider: posts to Workers AI's /ai/run with {model, input} and unwraps the run record {state, result: {answers}}; the old per-model path answered "No route for that URI". First verified against the real endpoint on 2026-09-22.
  • Proxy: the worker entry exports only the handler; wrangler dev refused to start while string constants were exported from it.
  • Smart paste: context-levelled pick question, heuristic fallback, hit-rate probe.
  • Two-track providers (decider: cloudflare, endpoint, none; generator: openai-compatible, anthropic, hosted, none) behind one egress layer with an offline switch and a destination-only log.
  • Actions: JSON format, five built-ins, user files and packs, paste --action.
  • Core daemon over JSON lines for the desktop app.
  • Proxy worker: hosted mode with subscriber tokens, quota, rate limit, generate, me, packs.
  • Release status docs and a manual native validation build; privacy audit checklist.
  • Card corpus of 100 samples; composer truncation, wrapping, script refusal, emphasis by the decider's word list.
  • Style packs: catalog fragments merged into the Core catalog at load. Installing packs and the account/subscription UI are not in the native app yet.
  • Privacy baseline 0.1.0: five automated checks pass; manual list recorded.
  • Generator: thinking models on Ollama (qwen3.5, gemma4) answered with empty content and the action reported success; the openai-compatible generator now detects it, retries with reasoning_effort: "none", learns, and exposes reasoning and timeoutMs (settings, providers.json, env). An action whose generator returns nothing is an error.
  • Engine: pinned to the public anelikes/pocket-motion v0.2.1 (the private branch stack replayed, plus paths through fileURLToPath); CI clones it without a credential, Rust pinned to 1.97.1 for the wasm build.
  • Decider rules, now the default: card kinds by the rule classifier (moved from the corpus script into core, 91% on the corpus), geometry by the length heuristics, picks by the heuristic; nothing configured, nothing leaves. Decider laya: a local Laya model behind scripts/laya/server.py, blended into the pick at a low weight; docs/laya.md.

The foundation — M0 of PLAN.md, which was M1 to M3 of the plan's first edition: the render chain as a package, the engine as a pinned dependency, the sidecar proven to run outside the repository, and the decision layer with its providers. No desktop app yet.

Added

  • paste: clipboard text to a card, a PNG, or a GIF when the text has an order worth revealing. Jev (TypeSafe AI, reached through Cloudflare Workers AI) answers seven typed questions about the text: kind, layout, palette, scale, tone, which word to emphasise, whether to animate. Every answer is a choice from a fixed set; Pocket Motion renders the composition with measured line breaks and sizes, never guessed.
  • Aspects chat, doc and social; --stdin; --dsl to render a DSL as-is and skip Jev; --out; --json (path, DSL and timings on one line) for a host program; --app-data and --engine-resources for the packaged app.
  • core/, the chain as a package: dsl.ts (validation), catalog.ts (every name Jev may choose with the numbers behind it; style packs are fragments of the same shape merged at runtime), questions.ts (the seven questions, answers to DSL), render/ (composition generation, engine driver, emoji, GIF), cli.ts.
  • Providers behind one interface: none (the plain card, no request), proxy (the wrangler dev worker in proxy/, the CLI default), cloudflare (Workers AI REST on your own account), hosted (our proxy, token-gated). Errors classified as auth, network, timeout, model, bad-response or quota, with readable messages.
  • Answers cached by the SHA-256 of the text and the question set, so the same text gives the same card; --fresh asks again.
  • engine.json pins Pocket Motion by repo, ref and sha. bun run setup (scripts/engine.ts) clones it at the pin and runs its setup steps, or verifies a checkout given by POCKET_ENGINE (--status, --fix).
  • Renders happen in a symlink work tree under .work/; the engine checkout is never written to.
  • GIF encoded in process with gifenc from the engine's frame source; no ffmpeg, about half the bytes of the ffmpeg pass.
  • Text measured against a cached metrics-only bake of core/src/render/charset.txt (ASCII, CJK punctuation, GB2312 level 1), so a paste costs one composition build; warm text-to-card about 1.2 s including Jev. A character outside the charset falls back to a per-paste measurement build.
  • Emoji as inline pictures: split out of the text (pictographs, keycaps, VS16, skin tones, ZWJ joins), fetched once as 128 px PNGs from Noto Emoji v2.047 through jsDelivr, drawn at the font size and measured as one advance when wrapping.
  • scripts/bundle-sidecar.ts: the sidecar the app ships, a Bun binary plus a 73 MB resource tree (engine subset, core/) that renders from a clean environment with no repository and no bun on PATH; cold start about 3.2 s, warm about 0.8 s.
  • scripts/fetch-emoji.ts: measures the full Noto Emoji 128 px set for the ship-the-set-or-a-subset decision.
  • Five DSL fixtures (plain, quote, code, stat, list) with the SHA-256 of the frames they render to at the pinned engine (core/fixtures/digests.json); 96 unit tests; CI runs the unit tests on Ubuntu and the fixture renders at the pinned engine on macOS.
  • PLAN.md: the v1 implementation plan, second edition: a smart clipboard first, cards as one action, two-track self-hostable providers.

Fixed

  • An animate=yes answer with tone 0 rendered a single frame. Jev answers the two questions independently, so the pair is reachable and now moves.