* make the labs card copy plain
Rewrite the Labs card titles and lines in words a regular user understands:
YOLO mode says the message sends itself, Live text and Failure notices name
the small recording indicator, Vocabulary help says which speech models it
affects, and the key-side cards name Option, Command, Shift, and Control.
Audit every other card, updating the CLI descriptions, all nine translated
languages, the website lab catalog, the feature docs, and the render goldens.
* fix labs copy review findings
Restore the ISO qualifier on the section-key card, spell out that
double-tap and hold-through shortcuts contain no letter or number key,
cover all Global mode stages in the API text card, and name the print
command in the print-start copy. Restore the developer API card titles,
fix the Annotate capture wording, and retranslate the affected strings.
Remove every replaced translation key and stale lab-name reference.
* fix second labs copy review
Update the live typing test and YOLO goldens. Add a Windows variant of the
hold-through-keys copy naming Ctrl, Alt, Shift, and the Windows key. Remove
the last unused rewrite-by-voice translation key, keep Annotate untranslated
in the replay title, and clean the remaining old lab-name comments.
* use the Polish Annotate pane name in its replay title
Polish calls the Annotate pane Adnotacje, so the Annotate last 15 seconds
title says Ostatnie 15 sekund w Adnotacjach again. Other languages keep
Annotate because their pane name is Annotate.
* 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
On an X11 session (DISPLAY set, WAYLAND_DISPLAY empty; never XWayland) Screen and Area are read from the X server: MIT-SHM GetImage each frame (plain GetImage without it), the pointer blended in from XFixes, 30 fps to x264 through ffmpeg. The screen is the RandR monitor under the pointer; `hex annotate start --area X,Y,W,H` records an area. i3 and other desktops without a ScreenCast backend now get video. A Window still needs the portal's picker and fails saying to record the screen or an area, never widening to the screen. When X11 capture can't start (no display, unusual depth, no ffmpeg/x264) the capture fails at once with why in the capsule instead of writing one with no picture.
Checked in a headless Xvnc + i3 session on apollo with no ScreenCast portal: an 800x500 area recorded 154 frames over 5.1 s, the 1920x1080 screen 153, each with a keyframe and the cursor. Also fixes scrawl-capture's own tests, which no longer compiled (ScreenCaptureSession.failure).
Reported and diagnosed by @nefthy.
* Merge recognition hints into the shared vocabulary
* Drop the unused text field helper
* Drop unused imports
* Cohere stands in for a model that ignores the vocabulary
* Update the picker golden for the Uses vocabulary badge
* x86_64: keep ggml on x86-64-v3 and refuse older CPUs with a clear message (#592)
Reverts #595's Ivy Bridge floor: it slowed CPU transcription for everyone. ggml goes back to its x86-64-v3 defaults (AVX2, BMI2, FMA, F16C). Hex's own Rust stays baseline x86-64, and the first thing main does on Linux and Windows x86_64 is check AVX2/BMI2/FMA/F16C with is_x86_feature_detected!. Without them Hex prints and shows "Hex needs a 2013 or newer processor (Intel Haswell / AMD Excavator or later) with AVX2. This PC's processor isn't supported." (a native MessageBox on Windows; stderr, which the journal logs, and zenity, kdialog or notify-send on Linux) and exits 1. Every command is covered except --version and --help, which installers and the updater run. ggml-cpu has no static constructors, so nothing runs v3 code before main.
The release guard now asserts the opposite: ggml's CPU libraries must hold AVX2 and FMA (the build targets v3) and no AVX-512 or AMX. Docs state the requirement.
* cpu_floor: harden DLL search first; no dialog under systemd, in a terminal or for hex service; guard rejects AVX-VNNI
* cpu_floor: always exit 1; Windows always shows the message box; Linux skips the dialog in a terminal, under NOTIFY_SOCKET, or for hex service
* Lowercase release file names; README downloads by channel (#456)
Release builds and the GitHub release mirror now name files hex-<version>-macos-arm64.{zip,dmg}, hex-<version>-windows-<arch>.exe and hex-setup-<version>-windows-<arch>.exe (Linux was already lowercase), as @vixalien asked in #456. Already-published files and the frozen 2.3.1 feeds keep their names; the release service's published names (hex, Hex.dmg, Hex.zip, hex.exe, HexSetup.exe) and the bundle (Hex.app) are unchanged, so the updater, installers, Homebrew cask, AUR and Nix are unaffected.
The README downloads table has Stable and Dev columns for every target, including the updater files. The site Worker serves /hex/download/dev/<target> (the dev alias) beside /hex/download/<target> (stable, or dev while there is none), and both now cover the bare updater files.
* Lowercase names in two remaining examples
* Lowercase the Windows executable in the CPU check step
* Talk only to a running OpenCode service; never spawn or probe a CLI
* wip
* wip
* Golden for OpenCode not running
* clippy
* fmt
* General's microphone meter wakes the window only while its bars show a level
* Feature map: the microphone meter rests in a quiet room
With the bar's pen on, ink goes down between mouse-down and mouse-up, like a real pen; moving with the button up draws nothing, and clicks still go to the overlay, not the app. The held Annotate key (and Shift on the Mac) still draws as the pointer moves, with no click. Linux takes the press and drag on the overlay; macOS reads the tap's buttons. How it works, the README, and the docs say so.
Checked in headless sway on apollo: a move without the button left no ink, a drag drew one stroke on screen and in scrawl.json, and the pen still clicks off through the overlay.
- 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.
The site's download buttons and the README/docs links name /hex/download/<target>, which the site Worker redirects per request to the release service's stable alias once stable.json exists and to the dev alias until then, so nothing needs switching back. The page labels the build ("Dev build 0.0.0-dev-N", with a note that it updates from the Dev channel) and refreshes the version from the live manifests. The Linux button names the site's own install-linux.sh. The anomalyco/homebrew-tap cask now installs the dev alias (version :latest, sha256 :no_check, auto_updates); the Release workflow's stable Homebrew job replaces it with a versioned cask at the first stable release.
- 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.
Wayland paste keeps wtype where the compositor offers
zwp_virtual_keyboard_manager_v1 and otherwise sends Ctrl+V through the
desktop's RemoteDesktop portal: one keyboard-only session, approved once
with a persisted restore token. With neither, the transcript stays copied
and the failure names the missing portal.
A loose binary writes its own managed hex.desktop so the portal can
identify it. Settings opens the GlobalShortcuts dialog (ConfigureShortcuts)
where the portal supports it, follows ShortcutsChanged, and treats an empty
trigger as refused.
Fixes#346
* Drop Input Monitoring: Accessibility covers the shortcut taps (t496)
* Regenerate goldens without the Input Monitoring row (t496)
* Regenerate the permissions golden after merging dev (t496)
* 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
https://anoma.ly/hex/files/install-linux.sh and install-windows.ps1 still served the 2.3.1 installers (Kit's frozen feed, ~/.local/share/voice-control). A new Installers workflow tests scripts/install-linux-release.sh and install-windows.ps1 without secrets and uploads them over those keys with .github/release/r2-put.sh, on every change to them on dev. Nothing else reads those keys: the 2.3.1 updaters read the frozen feeds and appcast. With HEX_INSTALL_CHANNEL unset, the installers now install the stable release, or the newest dev build (on the Dev update channel, with a message) while the release service has none, so the README's command works today.
* 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
* Linux ARM64, .deb, and .rpm releases
Both Linux architectures build natively on Ubuntu 24.04 runners (glibc 2.39
floor, Vulkan on both), publish linux-arm64 plus linux-<arch>-deb and -rpm
(hex.deb, hex.rpm) built with nfpm and installed on Ubuntu and Fedora in the
build job. hex-bin gains aarch64. Package installs report deb-<arch> or
rpm-<arch> through dpkg/rpm ownership and get the stable update command.
* build-linux.sh prints only the executable's path
* Linux releases link no system BLAS, as the Arch build shipped
* Linux build: keep libopenblas-dev for build.rs's dropped -lopenblas
One row per OS and architecture linking the release service's dev alias (https://anoma.ly/release/hex/desktop/dev/<target>), plus the updater files. The GitHub mirror note no longer links an app-v tag, and the managed-network note drops Kit's old download host.
Release no longer runs on tag pushes; stable is a dispatch from production only and refuses a version already tagged v<version> or app-v<version>. After every platform and the release service published, a tag job pushes v<version> on the released commit with the release deploy key (HEX_RELEASE_TAG_KEY, admitted by the new v* tag ruleset), then the GitHub release mirrors the files on that tag; a failed run leaves no tag. A check run pushes and deletes a throwaway v0.0.0-test-<run> tag to prove the ruleset admits the key. The release environment now admits only dev and production.
Work lands on dev, the default branch. production holds what was released
(app-v2.3.1) and moves only by a fast-forward from dev. Pushes to dev run the
checks, test builds, and the dev site deploy; stable releases run only from
production or an app-v tag, and the TypeScript SDK's version pull request
targets dev while publishing waits for production.
Hex polls anoma.ly/release/hex/desktop/<channel>.json on every OS and decides
with the release protocol's client rules (the service's shared test vectors in
tests/fixtures/release-protocol): strictly newer unless revoked, the minimum
version before rollout, and a device-local rollout bucket that is never sent.
Direct installs (Linux and Windows with the installer's receipt, macOS a
replaceable Hex.app) download resumably, check size and SHA-256, then the OS
code signature (macOS app/update-requirement.txt: Developer ID 5NZ4Q7NXJ4,
anomaly.hex, notarized; Windows Authenticode from Anomaly's Artifact Signing
identity), and stage the update for Restart to update. macOS swaps the bundle
in with renamex_np(RENAME_SWAP) at restart or quit; a read-only location links
to the DMG. Package-managed installs show their manager's command; source and
test builds never check; DisableUpdates (macOS defaults, Windows policy key)
turns checks off.
Sparkle, its framework, Info.plist keys, appcast generation, and the ed25519
feeds are gone. release-app.sh prepare leaves Hex-<v>-macos-arm64.dmg and .zip
(root Hex.app). Macs on 2.3.1 get packaging/macos/legacy-appcast.xml: one
informational item linking to anoma.ly/hex.
The Release workflow uploads each target and the release to anoma.ly/release (dev.anoma.ly/release for staging) with curl and its GitHub OIDC token, records the AUR, Homebrew, and Nix distributions, mirrors the files to GitHub, and builds hex-bin from the published file. The ed25519 feeds, appcast generation, and Sparkle ZIP naming are gone; the 2.3.1 feeds stay frozen. Builds and installers use the release service names, the installers read the stable manifest and write the direct-install receipt, and the site reads its download links from the manifest.
It is the Hex voice dictation app, not a prebuilt of extra/hex (a hex dump tool that installs /usr/bin/hx), so it neither provides nor conflicts with it, and its description says so.
One site/cloudflare.config.ts defines the production Worker hex (anoma.ly/hex, bucket hex-production-files) and the dev Worker hex-dev (dev.anoma.ly/hex, bucket hex-dev-files), deployed only from CI with cf deploy --prebuilt --mode. The Worker serves the site and the release bucket; apps, scripts, the release workflow, and docs use https://anoma.ly/hex/files. Staging releases publish to the dev bucket; stable releases deploy the production site.
A staging channel dry-runs the whole pipeline under staging/<run-id>/ with a draft GitHub release; uploads use the bucket-scoped R2 S3 credentials. Adds the hex-voice-bin AUR package and docs/releasing.md.
Rewrite the design system as a short rune-kit and OpenCode theme page, and
update AGENTS.md, the feature maps, the Linux, Windows, and Nix guides, the
roadmap, and the port plans: --snap scenes replace GPUI previews, and checks
that went with GPUI are recorded as gaps.
Wayland shortcuts no longer read /dev/input. One state machine in
linux_input now serves every source:
- X11: the existing key grabs, with auto-repeat filtering split out and
tested, and the inline gesture flags replaced by the shared rules.
- Wayland with the GlobalShortcuts portal: Register("hex"), one session for
dictation, Paste Last, and Voice Action, and a second session that binds
Escape (also with the held shortcut's modifiers) only while recording.
Activated/Deactivated are press/release; refused shortcuts and the
trigger the desktop actually granted show in Settings; a closed session
cancels and stops the listener with an error.
- Everywhere: `hex dictation start|stop|toggle|cancel`,
`hex voice-action start|stop|toggle`, and `hex paste-last` talk to the
running service over its socket for desktops without the portal. They
are idempotent, never start the service, and fail clearly when it is
missing or not listening.
Settings records shortcuts from its own key events on Wayland too, lists
the granted triggers, or, without the portal, hides the shortcut rows and
lists the commands. Wayland paste no longer waits for held modifiers:
wtype's virtual keyboard sends its own, and the Wayland paste smoke now
pastes while another keyboard holds Ctrl and Alt.
Removes linux_wayland_input.rs, the evdev and udev crates, libudev-dev in
CI, and every input-group requirement from the docs. Also gates
AppWindowPreview::pane to macOS, whose only callers broke the Linux
Clippy build.
* feat(macos): move the data folder from voice-control to hex
* fix(macos): match Hex's folder precedence in SDK and scripts; re-create a missing compat symlink
* feat(windows): a per-user Setup.exe installer for the managed layout
* feat(release): build, test, and publish Setup.exe installers and the GitHub download mirror
* fix(onboarding): name the tray on Windows and the background service on Linux; keep Apps & Features on the updated version
* feat(site): one site with a platform-aware download section; retire hex.kitlangton.com
* feat(site): prerender the page, add robots, sitemap, llms.txt, JSON-LD, and favicon.ico