Releases: vxcozy/louder-bridge
Release list
Louder Bridge v0.3.3
Louder Bridge 0.3.3
This prerelease fixes Hermes setup when a named profile is active.
What changed
- Louder Bridge now asks Hermes which profile is active and installs its plugin
beside that profile's config file. - Every command in the setup transaction stays pinned to the same profile,
even if the active Hermes profile changes before setup finishes. - Uninstall checks the default profile and every named profile for managed
copies of the plugin. - Setup, upgrades, removal, and rollback preserve unrelated Hermes settings
and refuse to delete a plugin directory Louder Bridge does not own. - Plugin-list cleanup rereads the current list before each removal instead of
reusing an old numeric index.
Voice input, Agent Key navigation, send, and lighting behavior are unchanged.
Validation
The setup problem was found while installing Louder Bridge on a second Apple
Silicon Mac. The updated named-profile path passed a real Hermes CLI smoke test
with an isolated profile.
The source passed 385 automated tests, including Node.js 22, 24, and 26. The
GitHub release workflow also built and verified the downloadable ZIP, its
checksum, app signature, contents, and SPDX SBOM.
Install
Download the Apple Silicon ZIP, move Louder Bridge.app to Applications,
and open it once. If macOS blocks it, open System Settings → Privacy &
Security and choose Open Anyway. Approve Input Monitoring and
Accessibility for Louder Bridge. Ghostty may also ask for Automation permission
the first time an Agent Key selects a terminal.
The GitHub build uses an ad-hoc signature, so macOS may ask for permissions
again after an upgrade.
Privacy
Louder Bridge runs locally. It collects no telemetry, audio, transcripts,
prompt content, project names, or session identifiers. Local diagnostics
require a private authentication token.
This remains a prerelease. Ghostty labels its AppleScript API as a preview, and
the device driver uses an independently documented protocol.
Louder Bridge v0.3.2
Louder Bridge 0.3.2
This prerelease completes Hermes CLI controls in Ghostty.
What changed
- Hermes lifecycle hooks can now associate a session with its Ghostty pane
even when the hook does not include a terminal ID. - Pressing MIC sends Hermes CLI's
Control+Bvoice shortcut. Releasing MIC
sends the shortcut again to stop recording. - Hermes voice input remains bound to the pane where it started. If focus
moves while MIC is held, releasing the key returns to the original pane
before stopping the recording. - Delayed terminal discovery can no longer restore an ended Hermes session or
replace the live session associated with that pane.
Claude Code keeps its hold-Space voice route, and Codex CLI continues to use
macOS Dictation.
Hardware result
The GitHub-built v0.3.2 archive passed its focused Hermes-in-Ghostty hardware
check over USB on August 8, 2026. MIC started and stopped Hermes voice input,
the Agent Key focused the correct pane, and the session lighting followed the
active session. The pane-switch test also passed: after focus moved while MIC
was held, releasing MIC returned to the original Hermes pane and stopped
recording there.
The archive checksum and app signature were verified before installation.
| Component | Version or result |
|---|---|
| macOS | 26.5.2 (25F84) |
| Ghostty | 1.3.1 |
| Hermes Agent | 0.19.0 (2026.7.20), upstream a4973c3f |
| Embedded Node.js | 22.23.1 |
| Codex Micro firmware | v0.4.1 |
| Connection | USB |
| Automated tests | 360 passed |
Install
Download the Apple Silicon ZIP, move Louder Bridge.app to Applications,
and open it once. If macOS blocks it, open System Settings → Privacy &
Security and choose Open Anyway. Approve Input Monitoring and
Accessibility for Louder Bridge. Ghostty may also ask for Automation permission
the first time an Agent Key selects a terminal.
The GitHub build uses an ad-hoc signature, so macOS may ask for permissions
again after an upgrade.
Privacy
Louder Bridge runs locally. It collects no telemetry, audio, transcripts,
prompt content, project names, or session identifiers. Local diagnostics
require a private authentication token.
This remains a prerelease. Ghostty labels its AppleScript API as a preview, and
the device driver uses an independently documented protocol.
Louder Bridge v0.3.1
Louder Bridge 0.3.1
This prerelease finishes the Ghostty controls introduced in 0.3.0.
What changed
- Agent Keys now focus the correct Ghostty window, tab, or split in mixed-agent
sessions. - Claude Code and Hermes use their hold-Space push-to-talk control when MIC is
held. - Codex CLI uses macOS Dictation when MIC is held.
- The send key sends Return to the focused terminal.
- First-run setup requests permission to control Ghostty, and status reports
that permission separately. - Local development builds can use a stable signing identity so macOS keeps
their permissions between rebuilds.
Hardware result
A locally built v0.3.1 candidate passed a mixed-pane USB test on August 8,
2026. One Ghostty pane ran Claude Code and another ran Codex CLI. Agent Keys
switched to the correct pane, both voice routes inserted speech, send submitted
each prompt once, and the key and exterior lighting followed both sessions.
| Component | Version or result |
|---|---|
| macOS | 26.5.2 (25F84) |
| Ghostty | 1.3.1 |
| Claude Code | 2.1.226 |
| Codex CLI | 0.147.0 |
| Embedded Node.js | 22.23.1 |
| Codex Micro firmware | v0.4.1 |
| Connection | USB |
| Automated tests | 355 passed |
Install
Download the Apple Silicon ZIP, move Louder Bridge.app to Applications,
and open it once. If macOS blocks it, open System Settings → Privacy &
Security and choose Open Anyway. Approve Input Monitoring and
Accessibility for Louder Bridge. Ghostty may also ask for Automation permission
the first time an Agent Key selects a terminal.
The GitHub build uses an ad-hoc signature, so macOS may ask for permissions
again after an upgrade.
Privacy
Louder Bridge runs locally. It collects no telemetry, audio, transcripts,
prompt content, project names, or session identifiers. Local diagnostics require
a private authentication token.
This remains a prerelease. Ghostty labels its AppleScript API as a preview, and
the device driver uses an independently documented protocol.
v0.1.2
Louder Bridge 0.1.2
This prerelease connects a Work Louder Codex Micro to local Claude Code
sessions in Claude Desktop. It supersedes the unpublished v0.1.1 draft.
What works
- Hold MIC to speak in Claude Code, then release it to stop.
- Use the key beside MIC to send text or answer an approval prompt.
- Use the six Agent Keys to open their assigned Claude Code sessions.
- See session state on the keys and exterior lighting. Unused keys stay softly
white. Active sessions use blue, green, amber, and red, including the blue
breathing effect. - Leave the bridge running in the background after one app launch and the two
required macOS permissions. - Keep using the Micro with Codex. Louder Bridge releases the device while
Codex is open and reconnects after Codex quits.
Fixed in this build
The installer now gives macOS enough time to restart the background agent.
The previous 10-second limit could collide with macOS's own restart throttle
and roll back a healthy upgrade. The corrected transaction completed on the
Mac that reproduced the failure.
Voice input, sending, lifecycle lighting, Agent Key navigation, Bluetooth,
USB-C, device handoff, and automatic reconnection have passed physical tests
on development builds.
On August 4, 2026, the downloaded v0.1.2 package passed its final physical
check. The app upgraded the background agent from v0.1.1 without rollback,
recovered after both macOS permissions were approved, and connected to the
Micro when Claude Desktop opened. All six Agent Keys and the exterior lighting
showed their standby and lifecycle colors and pulse effects. MIC press and
release controlled voice input, the adjacent key sent Return, and the bridge
released the Micro when Claude closed so Codex could use it again.
Compatibility
- Apple Silicon
- macOS 15 or newer
- Claude Desktop with local Claude Code workspaces
- Codex Micro firmware v0.4.1
Privacy
Louder Bridge runs locally. It collects no telemetry, audio, transcripts,
prompt content, project names, or session identifiers. Its local diagnostics
require a private authentication token.
Download
The release contains an Apple Silicon ZIP, its SHA-256 checksum, and an SPDX
SBOM. The app uses an ad-hoc signature, so macOS may require Open Anyway in
System Settings → Privacy & Security on first launch.
Install Louder Bridge.app in Applications, open it once, and approve
Input Monitoring and Accessibility. Normal use does not require Terminal.
This is a prerelease, not the stable v1 release.