* Stage clipboard-preserving capture insertion for Paste Last on Mac
* Update Rune and its Nix source hash for the picker work
* Select the latest ready paste by owner identity and revalidate it
* Exercise a held mixed paste picker with real bundles and a private Mac pasteboard
* Publish ready Annotate identity and queue owner-specific paste requests
* Wire the existing Mac paste shortcut and controls to the opt-in mixed picker
* Recheck the selected field and cover Paste Last with a disposable Mac receiver
* Refresh the Rune revision for the unified History pane
* Unify Mac History and keep only spoken words after a deliberate dictation cancel
* History and Paste Last call a Hex capture an annotation (t1612)
A finished Hex capture is an Annotation in History, its details and the
Paste Last picker, and the type filter is Annotations. The Captures pane no
longer rewrites its own label when the unified History is on, and the search
index drops the old synonym. Scrawl stays only as Scrawl.app and the on-disk
.scrawl format; a Hex-owned format is separate file and engine work.
* Gate the unified History behind a Labs toggle and give it one row shape (t1612)
Labs › Paste Last picker (labs.paste_last_picker; macOS, Dev audience, off by
default) replaces HEX_EXPERIMENTAL_PASTE_LAST and is read where the work
starts: the picker and its gesture, History's unified list, and the cancel
path's word writer. Off, Paste Last and History behave exactly as before.
History's rows now share one shape for dictations, annotations, screenshots
and recordings; a capture's detail card carries its picture, words, facts and
actions; a search or the type filter never leaves a stale card open; an empty
History has one empty state; and the type filter shows only when there is more
than one kind to filter.
The picker's rows sit on its title's left edge.
* Show the Paste Last picker card on macOS only (t1612)
* Refresh the Labs goldens for the Paste Last picker card (t1612)
* Keep the unified History's capture helpers to macOS builds (t1612)
* Keep the unified History's fixture pictures behind the Mac capture gate (t1612)
* Point the docs at the Paste Last picker lab (t1612)
* fix(dictation): release the warm mic while the display sleeps or the screen is locked (#1953)
* fix(dictation): address review on warm mic away release
* docs: fix hex microphone resume wording
* cli: hex dictation start --print keeps a dictation from pasting (labs)
A client that starts a dictation to insert the text itself loses it when
the person finishes the locked recording with the shortcut, or when a
microphone loss salvages it: Hex pastes or copies into the focused app.
`hex dictation start --print` (macOS, behind Labs › Print-only CLI
dictation / `labs.print_start`) blocks and answers with the transcript
however the recording ends, so nothing is pasted or copied. It is busy
while a dictation records, a plain `stop` answers done, `stop --print`
joins the same transcript, no speech exits 4, a cancel or failure exits
1, and it waits at most 31 minutes. Linux and Windows answer
unsupported; CONTROL_VERSION stays 4.
# Conflicts:
# src/labs.rs
# src/rune_ui/labs.rs
# tests/golden/rune-mac-labs-dark.png
# tests/golden/rune-mac-labs-light.png
# tests/golden/rune-mac-labs-link-dark.png
# tests/golden/rune-mac-labs-link-light.png
* cli: harden hex dictation start --print's endings
# Conflicts:
# src/labs.rs
* cli: bind the printing-start test's shortcut to Option
* labs: regenerate the Labs goldens for both new cards
* add pause from menu bar lab (#82)
* pause: hold a resume through Caps Lock and follow the pause in the menu
The neutral-keyboard check skipped Caps Lock and a stale Fn flag, the
menu kept saying Pause Hex while a resume waited, and every listener
pass took the pause lock. Also gate Caps Lock dictation on suspended
shortcuts, refresh secure-input hotkeys at once, and correct the labs
doc's claims.
* pause: drop the unused pause and resume entry points
* keep an interrupted dictation instead of discarding it (#1645)
* address review: raw salvage, silent loss, engine state
* docs: clarify interrupted dictation keep
* more dictation shortcuts: up to four extras, each with its own mode
Labs › More dictation shortcuts (macOS) adds up to four more dictation
shortcuts beside the main one. Each saved row keeps its own binding and
activation mode, registers only while the Lab is on, and shares no key
with another active shortcut. Settings records, clears, and rebinds each
row; the listener runs every press through the same capture pipeline, so
each shortcut finishes with the mode it was pressed with.
* more dictation shortcuts: review fixes
* more dictation shortcuts: follow lone-modifier double-tap, narrow globe check
* more dictation shortcuts: doc nits
* more dictation shortcuts: rebase fixes
Moves the recorded-shortcut checks beside the rest of the shortcut text in
`control/settings/hotkeys.rs` so `control/settings.rs` stays under the
1,500-line ceiling, drops the `labs.rs` size exception now that dev moved the
Feature registry into `labs/feature.rs`, and counts Meeting notes file
alongside More dictation shortcuts in `Feature::ALL`.
Adds Labs › Return to app (`labs.return_to_app`, macOS only, off by
default). While on, a dictation records the app in front as its capture
starts and, right before a Paste or RawPaste output commits, brings that
app back to the front if another one came forward: activate, poll the
frontmost pid every 10 ms for up to 500 ms, settle 50 ms, then paste.
When the app is gone or focus can't be confirmed, nothing is pasted. The
job fails with "couldn't switch back to the app you started in; use Paste
last dictation" (error tone and HUD as any failure), the text becomes the
last transcript so Paste last dictation pastes it, and History records
nothing because only pasted output is kept.
Voice Action, Paste last dictation, meetings, and Labs › Copy dictation
only never switch. Off, no pid is read and output is exactly as before.
* Talk over a screenshot: dictation words go with the shot
* Regenerate the screenshot editor goldens with the words row
* Cover the card held while someone talks over it
* Add the listening card's goldens
* Record the screen from Screenshots, ending in the corner card and a trim editor
* Move the capture timeline out, add the recording goldens and feature map
* Keep the replay's start on Windows quiet
* Keep the timeline move's imports and the replay start quiet off macOS
* Clear the record shortcut without returning its change
* Fix the macOS lints the recording left
* screenshots: only the open editor takes a dictation
A dictation taken while only the corner card showed used to talk over the
shot: the card held, showed "Listening…", and the words opened the shot in
the editor. That took the shortcut's normal paste away from everyone who
never asked for it.
Now only an open editor takes the words. While the card shows, a dictation
pastes as it did before the Lab, the card keeps its few seconds, and its
listening pill, hold and the narration path that opened the shot are gone.
The card's own card/listen/heard API goes with it, so nothing else can reach
the shot but the editor.
The i18n Screenshots rows move to i18n/labs.rs, where the Labs rows live,
so the main table stays under the source cap after dev's merge.
* screenshots: the editor's pieces come from the kit, and a shot grows in from where it was taken
The editor's toolbar was hand-made: five canvas-drawn tool glyphs in bespoke
hover chips, a bare ✕, a bare microphone, and action buttons stretched past
the kit's own height. The card's ✕ was a filled button beside them. They now
come from the rest of Hex: the tools are line icons beside the theme's own,
drawn by rune-kit icon buttons that fill while a tool is picked, ✕ and the
microphone and clear-words are the kit's ghost icon buttons like a capsule's,
and Copy, Save and Send to… are the kit's buttons at their own size. The
trim handles take the kit's corner.
A shot now grows in from the rectangle it was taken from. The card's overlay
is the whole display, so it can start anywhere on it: an area or window shot
starts at exactly the rectangle captured, at that size and place, and springs
into its corner slot on one spring that never overshoots its size, leaving
the same way. A whole-display shot keeps the slide in from the edge, and
Reduce Motion still only fades.
* screenshots: regenerate the editor and card goldens for the look pass
* docs: the card grows in from the shot's rectangle, and the editor is the kit's
* screenshots: a recording saves itself to the screenshots folder, as a shot does
* screenshots: cards stay until closed, stack in the corner, and take CleanShot's keys
* screenshots: Restore Last Capture in the menu bar brings back the card closed last
* screenshots: a Captures pane lists the last 30 days of shots and recordings
* screenshots: goldens for the card stack and the Captures pane, and its playground paths
* screenshots: the card's Return and the editor's file are macOS-only
* screenshots: pin that cards of any shape share the corner's right edge
* screenshots: keep macos_rune.rs and app_settings.rs under the file cap
* local api: optional output processing behind a lab
* local api: share one processing state with listeners
* local api: process one transcript at a time
* docs: clarify the processing route checks
* stop launching osascript on every context poll
the foreground context monitor read a scriptable browser's page through osascript every 500 ms, and the meeting watcher queried browser tabs every second for a whole call. launching processes that often leaks WindowServer ports until macos kills it. the monitor now reads the page once per frontmost browser and once per dictation shortcut, and the meeting tab probe backs off to every 30 s after its first 30 s.
fixes#1565
* request the page refresh once a capture is real
* docs: say when a discarded press still reads the page
* feat(windows): /dictations records with Hex's own microphone, and a dictation can stream its live text
Windows Hex started its local API without a dictation control, so
POST /dictations answered 404 service-capture-unavailable and apps had to
record the microphone themselves for /streams, ignoring the microphone
chosen in Hex.
The Windows listener now drives the same dictation::service owner as
Linux: one capture at a time beside the shortcut, the saved microphone,
pre-roll, While dictating, the lease, levels, and the HUD.
A start may also ask for the text so far ("partials": true). Hex then
holds a live-text demand for the recording's stream and sends
{stable, tentative} on GET /dictations/{id}/partials until the dictation
ends. /capabilities reports dictationPartials: true on Linux and Windows;
macOS doesn't stream a client's recording, so it reports false.
* fix(macos): no dead /dictations partials code where the recognition loop has none
* labs: caps lock dictation toggles hands-free dictation
A new macOS Shortcuts lab (labs.caps_lock_dictation, off by default) makes a physical Caps Lock press start a hands-free dictation and the next press finish it. Every press clears the system Caps Lock state so typing stays lowercase, and the key's LED shows Hex's state: solid while recording, blinking while a job transcribes or processes, off when done, cancelled, or failed. Turning the lab off or quitting clears the light and stops forcing the lock off.
Detection comes from the raw HID tracker's Caps Lock usage and the event tap's AlphaShift flag, deduplicated by arrival time. A dedicated worker owns all IOKit work (LED element writes, IOHIDSetModifierLockState, the blink timer) so neither the event tap nor the audio thread touches IOKit. The feature feeds a small light model alongside the HUD's one-consumer event channel rather than taking it over.
The Labs page mac-labs and mac-labs-link goldens are regenerated.
* suppression: group tap switches for caps lock cleanly
run_event_tap took eight arguments after the Caps Lock cancel flag, which clippy rejects. Group the three callback-visible switches into TapFlags instead of suppressing the lint.
* labs: harden caps lock dictation after review
Accept a press only when the HID Caps Lock key-down and its AlphaShift edge agree within a bounded window, so a remapped Control/Escape press never toggles and the lock-reset edge is ignored. Carry the HID press timestamp to the listener and forward presses before any IOKit work.
Keep the LED model on the listener and publish the pattern through an atomic the worker reads. The worker recreates its LED manager on the bounded refresh with an LED-page matching dictionary, so later keyboards join, and stale elements are not re-enumerated on every blink.
Only submission adds a light job and stage events for older or unknown jobs change nothing. Send JobCancelled for canceled worker jobs. Make Caps Lock starts stand down over pending double-tap gestures, and add the Hold-mode Escape exception to AGENTS.md and the docs.
* caps lock: fix macOS clippy findings
Drop the unused AtomicU64 import and borrow the capture host mutably for recording_since, which takes &mut self.
* caps lock: keep the worker handle live through shutdown
Read the JoinHandle when disabling so a timed-out worker detaches explicitly instead of triggering dead_code, and the listener never joins indefinitely.
* caps lock: match device times and own LED retains
Use IOHIDValueGetTimeStamp, scaled through the shared HID clock helper, as the press time and boundary. Match a HID press and an AlphaShift edge in either arrival order by absolute timestamp difference, keep unmatched evidence until a match, and mark Hex's own reset edges so they never enter the gate.
Give each cached LED element an owning Drop that releases exactly one device and one element retain, so multiple elements cannot over-release and clear() cannot leak. Log a missing IOHIDSystem connection, seed the tap's AlphaShift state when the lab turns on, and document the confirmation-window limit.
* caps lock: guard Annotate and fix LED keys
Skip a Caps Lock start while Annotate records while still allowing a running Caps Lock capture to finish. Use the real IOHIDKeys.h element keys (UsagePage/Usage) for the LED matching dictionary. Mark reset edges explicitly in the docs, seed/clear the AlphaShift state after a successful reset so RESETTING cannot swallow a real on-edge, and document the built-in-keyboard and light-race limits.
* caps lock: carry failure notices through the LED model and goldens
* caps lock: hand the HUD its own copy of each indicator event
* feat(annotate): prototype 15 s rolling replay buffer on macOS 27 (t1289)
* fix(capture): gate macOS-only replay imports and helpers on non-macOS (t1289)
The local API's running-app dictation now records on the Linux listener with
the macOS contract: owner tokens, the ten-second lease, levels, the audio tap,
and the same error codes. The protocol, completion record, lease and meter move
to dictation::service, which both platforms share; Linux drives them through
ServiceDictations. A client's dictation and a shortcut or hex dictation capture
never end each other: a start while the shortcut records is dictation-busy, and
the shortcut does nothing while the client's dictation records.
* Remove dictation cancel: Escape ends nothing (#786)
* Format and refresh the sound sets and commands goldens
* Release Escape before finishing in the held-capture test
* Ask browsers for their page only when a mode is chosen by website
* Keep the page for OpenCode rewrites and script transformations
* Keep the page for meeting detection and keep built-in lookup private
Records like the dictation shortcut and pastes the transcript as heard,
skipping replacements, corrections, transformations, and rewriting. Unbound
by default; set in the Output pane, raw_dictation_hotkey, or
hex dictation start|toggle --raw. History keeps it as Raw.
Suggested by @ksajan.
- One Annotate key: tap to start and stop; held while recording, the pointer draws with no click (macOS and Linux; Linux reads the portal's Activated/Deactivated). The separate Ctrl+Alt+D draw shortcut is gone. Linux defaults to F9; saved bindings stay.
- The recording capsule is `● 0:07 │ ✎ │ ■ ✕`: icons only, no Area/Window/Screen chips. The pen toggles drawing and lights with the accent fill; ■ stops; ✕ keeps the two-step discard. Tooltips: Draw, Stop, Discard.
- While drawing the ink overlay takes the pointer with a pen cursor; on Linux it leaves a hole over the capsule so the pen can be clicked off. Esc stops drawing, never the recording. Shift still draws on the Mac.
- Pins (Shift-click, click while drawing) and undo (⌘Z, Ctrl+Z, right-click) are removed with their plumbing.
- How it works in Settings › Annotate lists the new steps, in all six languages. Goldens: recording, recording-drawing.
- Linux draws while Ctrl+Alt+D is held (portal Activated/Deactivated), as Shift on the Mac; moving draws, a click pins, right-click or Ctrl+Z undoes. `hex annotate draw` stays a toggle.
- The send-to list shortcut (capture.list_hotkey, ⌥⇧L / Ctrl+Alt+Shift+V) is gone; Send to… is a capsule click beside Paste and Inspect.
- Sends attach the contact sheet and up to 8 keyframes inline as data: image parts, with no local path in the prompt, so remote OpenCode servers get everything.
- Dictation and Voice Action start nothing while Annotate records (macOS and Linux).
- Linux Paste pastes the contact sheet, then the summary, as the Mac does; the Linux capsule doesn't open suggestions by itself.
- Settings › Annotate gains How it works.
- Rename the feature Annotate wherever people see it: the pane and sidebar,
its rows in six languages, `hex annotate` (alias `hex capture`), README,
feature map, and AGENTS.md. Code and settings keep `capture`.
- Retire the `capture` experiment: compiled into every macOS and Linux build,
`capture.enabled` on by default, and a one-time migration that turns it on
for older settings and moves the send-to list off Paste Last's key. The
macOS list default is now Option-Shift-L.
- Linux drawing: Ctrl+Alt+D while Annotate records makes the ink overlay take
the pointer; a drag is ink, a click a pin, a right-click undoes. The
send-to list shortcut is bound through the portal too.
cpal's Device Display returns fmt::Error when a device's name can't be
read, so to_string panicked the microphone list and listener on a Mac
with no input. Read names through description() and skip unnamed
devices, so no input follows the bounded recovery path. Status now says
No microphone while recovering, and Stopped with capture unknown once
the listener worker returns an error or panics.
Fixes#341
* Run personal commands in embedded QuickJS instead of Bun
Hex now runs ~/.config/hex/hex.config.ts in-process: rquickjs on one worker
thread, TypeScript erased to same-position JavaScript with oxc's parser,
per-call time limits and a runtime memory limit, and no filesystem, network,
process, or timer API. Handlers return actions that Hex validates and runs on
its native executor. The Bun host, managed SDK provisioning, bun update, the
sdk/commands workspace, and their scripts and CI steps are gone; Hex writes
hex.d.ts typings instead, and hex commands check replaces bun run check.
Plan and measurements: docs/plans/quickjs.md.
* Spell out a range check that a new dependency's impls made ambiguous
* Rename voice-control to hex everywhere, without migrations
The Cargo package and binary are now hex, every OS keeps its data in a
hex folder, and VOICE_CONTROL_* variables are HEX_*. Hex is a fresh
app: the macOS voice-control rename, its symlink, and the Windows and
Linux beta settings imports are gone. The Windows installer gets a new
AppId so it never takes over an old voice-control install's entry.
* Format
* Drop the Windows paste-last default only the beta import used