RELEASE_NOTES

Version history and changelog for AudioBash.

v3.2.0 LATEST March 11, 2026

Customizable pane colors with activity fade

Each pane gets a user-chosen color from an 8-color palette. Colors fade through brightness steps as terminals go idle, and turn red on error exits. Exit now closes panes automatically, and focus tracking works for all grid positions.

Pane colors

  • - 8-color preset palette - Emerald, Cobalt, Crimson, Violet, Cyan, Amber, Rose, Acid
  • - Activity fade - Full color (0-15s), fading (15-30s), dim (30-60s), gray (60s+)
  • - Toolbar color picker - Click the swatch to open a popover with all 8 colors
  • - Persistent colors - Pane colors saved to localStorage, survive restarts
  • - Error override - Non-zero exit always shows red, regardless of pane color

Pane behavior

  • - Exit closes pane - Shell exit (e.g., typing "exit") automatically closes the pane
  • - Focus tracking fix - Bottom panes in grid layout now track focus correctly
  • - 6 activity states - Active, fading, dim, inactive, done, error
v3.1.0 March 11, 2026

Developer ID code signing for macOS

macOS builds are now signed with a Developer ID Application certificate, the same type Apple requires for distribution outside the Mac App Store. Right-click → Open now works reliably on first launch. Roadmap redesigned with milestone-based planning.

Code signing

  • Developer ID Application cert - Signed by Joe Amditis (5624SD289G), verified by Apple's full certificate chain
  • Hardened runtime - Required for future notarization, now enabled on all macOS builds
  • Gatekeeper compatible - Right-click → Open works reliably on first launch

Other changes

  • Roadmap redesign - Milestone-based layout with v3.1, v3.5, v4.0, and exploratory tiers
  • Blog posts - Origin story, first user testing, Anthropic /voice mode
  • Doc cleanup - Removed stale provider references, updated latest.html
v3.0.3 March 11, 2026

Pane stability, toolbar redesign, remote control removal

Fixes pane/terminal synchronization bugs when switching presets, replaces bracket-text toolbar with SVG icons, removes the mobile remote control feature, and adds a terminal ready-signal handshake to eliminate output race conditions.

Pane system fixes

  • Terminal pool - Preset switching reuses existing terminals instead of creating/destroying, preserving custom tab names and content
  • Ready-signal handshake - PTY output is buffered until xterm mounts, then flushed; eliminates empty panes on preset cycling
  • React key tracking - Terminal components use stable keys for correct reconciliation during tree restructuring
  • Focused pane highlight - Acid-colored ring on the active pane

Other changes

  • Toolbar redesign - Replaced bracket-text buttons with clean SVG icons matching the void/brutalist aesthetic
  • Remote control removed - Removed the mobile remote control feature (WebSocket server, PWA client, all related UI, tests, and docs)
  • Duplicate key fix - Tab counter uses useRef instead of useState to prevent stale closures in async loops
v3.0.1 March 10, 2026

Voice panel improvements + raw mode default

Patch release improving the Claude Code /voice mode UI in the voice panel and fixing the smart handoff behavior.

Voice panel

  • [CC /voice] badge - Shows in panel header when CC voice is active
  • Mic button disabled - Amber styling when CC /voice is active
  • Status text - "CC /voice active" shown below mic button
  • Raw mode default - Transcription now defaults to raw (verbatim) mode

Bug fix

  • Smart handoff fix - Now cancels recording instead of stopping when CC /voice activates, preventing partial transcriptions from being sent to the terminal
v3.0.0 March 10, 2026

Tmux-style panes + Claude Code /voice integration

Major release with a rebuilt pane management system using binary tree architecture, Claude Code /voice mode detection with smart handoff, and a batch of bug fixes for notifications, window management, and terminal stability.

Bug fixes

  • Notification chimes - AudioContext pre-warm, oscillator fallback
  • Window drag regions - Fixed frameless title bar dragging
  • Window persistence - Position/size saved across sessions
  • Font zoom - Ctrl+Plus/Minus/0 to adjust
  • Terminal resize - Improved reflow stability

Tmux-style pane system

  • Binary tree architecture - Rebuilt pane management
  • Split panes - Alt+- horizontal, Alt+\ vertical
  • Drag dividers - Resize panes, double-click to equalize
  • 5 preset layouts - Single, side-by-side, stacked, 2x2, main+sidebar
  • Keyboard nav - Alt+Arrow to move, Alt+1-4 direct focus
  • Resize from keyboard - Alt+Shift+Arrow
  • Zoom pane - Alt+Z to zoom/unzoom focused pane
  • Named sessions - Save/load pane layouts
  • Max 4 panes - Up to 4 concurrent terminals

Claude Code /voice integration

  • /voice detection - Detects Claude Code /voice mode in terminal output
  • [CC /voice] indicator - Shows when /voice mode is active
  • Smart handoff - Voice routing between AudioBash and Claude Code
  • Multi-terminal routing - Voice directed to correct terminal
v2.4.1 February 14, 2026

Remote simplification + code signing infrastructure

Stripped ~31K lines of tunnel services, React PWA, and voice bridge from the remote control system. Added macOS code signing infrastructure (entitlements, notarization hook, hardened runtime) in preparation for signed builds. Set up GitHub Sponsors.

Changed

  • Remote simplification - Removed tunnel services, React PWA, and voice bridge (~31K lines)
  • Code signing infrastructure - Entitlements, notarization hook, hardened runtime config
  • GitHub Sponsors - Sponsor button and funding links added

Added

  • Entitlements plists - JIT, unsigned memory, library loading, microphone, networking
  • Notarization script - afterSign hook for Apple notarization service
  • afterPack improvements - Detects real vs ad-hoc signing identity
v2.4.0 February 13, 2026

Electron 39 + Apple Silicon crash fix

Upgraded Electron from 35 to 39 (fixes macOS Tahoe GPU lag). Fixed the silent crash on Apple Silicon Macs caused by invalid code signatures on node-pty binaries. Added crash-proof startup with global error handlers. Confirmed working on M1 hardware.

Changed

  • Electron 35 → 39 - Fixes macOS Tahoe GPU lag (_cornerMask override)
  • electron-builder 25 → 26 - Latest build tooling

Fixed

  • Apple Silicon crash (#29) - Re-sign node-pty binaries after chmod to preserve ARM64 code signatures
  • Silent startup exits - Global error handlers + try-catch in app.whenReady()
  • Tray icon crash - Skip tray creation if icon fails to load
v2.3.6 January 16, 2026

Mobile auxiliary keys & test coverage

Added terminal auxiliary key row for mobile remote app with Tab, Esc, Ctrl+C, and more. Samsung S24 Ultra viewport optimizations. Expanded test suite to 1000+ passing tests.

Added

  • Mobile auxiliary key row - Tab, Esc, Ctrl, Alt, ^C, ^D, ^Z, pipe, tilde, backtick, arrow keys
  • S24 Ultra viewport optimizations - Tailored layout for 412dp width portrait mode
  • Modifier key state machine - Toggle Ctrl/Alt with auto-reset after use
  • Haptic feedback - Vibration on aux key press (where supported)

Fixed

  • Service worker cache - Proper cache invalidation for PWA updates
  • localStorage wrapper - Handle tracking prevention in Edge/Safari
  • Test suite fixes - All tests now passing (1019 tests)
v2.3.5 January 15, 2026

Remote connection & Whisper fixes

Fixed WebSocket proxy compatibility for Cloudflare tunnels, password handling improvements, and Whisper.cpp path resolution for local transcription.

Fixed

  • Remote connection fixes - WebSocket proxy compatibility for Cloudflare tunnels
  • Password/pairing code fixes - Removed auto-capitalize from remote app
  • Whisper.cpp path fix - Fixed binary path resolution for local transcription

Changed

  • Simpler passwords allowed - Password complexity changed from error to warning
v2.2.0 January 12, 2026

ElevenLabs real-time fix

Fixed ElevenLabs real-time transcription, added mobile image upload feature, and new /latest page for quick changelog access.

Fixed

  • ElevenLabs real-time transcription - WebSocket streaming now works correctly

Added

  • • Mobile image upload feature for remote client
  • • New /latest page for quick changelog access
v2.1.1 January 12, 2026

API connectivity fix

Critical fix for Content Security Policy that was blocking connections to ElevenLabs, OpenAI, and Anthropic transcription APIs.

Fixed

  • CSP blocking API connections - Voice transcription now works with all providers
  • • ElevenLabs Scribe v2 WebSocket connections
  • • OpenAI Whisper API connections
  • • Anthropic API connections

Other changes

  • • Updated remote client for Cloudflare tunnel support
  • • Simplified mobile remote UI (uses native voice keyboard)
  • • Added WebSocket protocol support for localhost
v2.1.0 January 10, 2026

ElevenLabs Scribe v2 Real-time

Real-time speech-to-text with ElevenLabs Scribe v2 WebSocket streaming. Ultra-low latency (~150ms) with automatic voice activity detection.

Added

  • ElevenLabs Scribe v2 Real-time - WebSocket streaming transcription
  • • ~150ms latency (vs seconds for batch)
  • • Built-in VAD auto-commit when you stop speaking
  • • Keyterms support - custom vocabulary for better accuracy
  • • New model: "ElevenLabs Scribe v2" in model selector

Technical

  • • PCM 16-bit @ 16kHz audio streaming
  • • AudioContext + ScriptProcessor capture
  • • WebSocket reconnection with exponential backoff
  • • Existing ElevenLabs batch API preserved as fallback
v2.0.2 January 2, 2026

macOS Stability & Stress Testing

Critical fix for macOS app launch failure and comprehensive stress testing suite.

Added

  • • macOS stress test suite (18 automated tests)
  • • PTY spawn/destroy cycle testing
  • • File descriptor leak detection
  • • Manual testing checklist for macOS
  • • End-user testing automation script

Fixed

  • Critical: App wouldn't launch on macOS due to spawn-helper missing execute permissions
  • • afterPack hook now properly fixes node-pty binary permissions
v2.0.1 January 2, 2026

Audio Notification Fix

Fixed false positive audio notifications when Claude Code mentions approval-related words in explanatory text.

Fixed

  • • Audio chimes no longer trigger on words like "approve" in explanatory text
  • • CLI input detection now uses end-anchored regex patterns
  • • Buffer cleared after match to prevent re-triggering
  • • ANSI escape codes stripped before pattern matching

Changed

  • • Only last 500 chars checked for prompts (was 2000)
  • • Patterns require specific formats like [Y/n] at end of output
v2.0.0 January 2, 2026

macOS Support

AudioBash now runs natively on macOS! This major release brings full feature parity between Windows and macOS with native Apple Silicon and Intel builds.

Added

  • • Full macOS support with native arm64 and x64 builds
  • • DMG installer for macOS
  • • Cross-platform shell detection (zsh on Mac, PowerShell on Windows)
  • • Platform-aware AI agent mode
  • • 120+ cross-platform tests
  • • CI/CD pipeline for multi-platform builds

Fixed

  • • xterm.js focus issues on macOS
  • • postcss.config ESM syntax for Node 18
  • • Icon size requirements for macOS DMG
v1.1.0 December 11, 2025

Custom instructions & vocabulary

Major release with personalization features and expanded keyboard shortcuts.

Added

  • • Custom instructions for raw and agent modes
  • • Custom vocabulary/pronunciations mapping
  • • CLI input notifications with audio chime
  • • 14 keyboard shortcuts (Alt+A, Alt+M, Alt+C, Alt+L, etc.)
  • • Resend last transcription (Alt+R)
  • • Tab switching shortcuts (Alt+1-4)
  • • Custom installer branding

Changed

  • • Voice mode state shared between App and VoiceOverlay
  • • Settings UI reorganized with categorized shortcuts
  • • Last transcription saved for resend feature
v1.0.4 December 11, 2025

Split view & tab management

Added

  • • Split view with 5 layout modes (single, horizontal, vertical, 2x2, 1+2)
  • • Resizable terminal panes with drag dividers
  • • Focus indicator showing which terminal receives voice
  • • Tab rename (double-click to edit)
  • • Custom installer branding with images
v1.0.3 December 10, 2025

Bug fixes & stability

Fixed

  • • Tray icon visibility in packaged builds
  • • Icon path resolution for production
v1.0.2 December 10, 2025

Context-aware agent & quick navigation

Added

  • • Context-aware agent mode (understands cwd, recent output, errors)
  • • Quick directory navigation panel
  • • Recent and favorite directories
  • • Directory bookmarking
v1.0.1 December 9, 2025

Initial public release

The first public release of AudioBash!

Features

  • • Voice-to-terminal transcription
  • • Multi-tab terminal support (up to 4 tabs)
  • • Multiple AI provider support (Gemini, OpenAI, Claude, Groq)
  • • System tray integration
  • • Global keyboard shortcuts
  • • Theme selection (Void, Cyberpunk, Matrix, Amber, Ice)
  • • CRT scanline effect

ROADMAP

v3.1

Stability & keyboard shortcuts

  • Pane system hardening
  • Voice pipeline reliability
  • Customizable keyboard shortcuts
  • Performance optimization
v3.5

Voice evolution

  • Voice command history browser
  • Continuous listening mode
  • Wake word detection
  • Audio input device selection
v4.0

Sessions, workspaces & signed distribution

  • macOS code signing & notarization
  • Auto-update via electron-updater
  • Named terminal sessions
  • Project-based pane layouts
  • Linux support (AppImage, .deb)
future

Exploratory

  • Local transcription (whisper.cpp)
  • Multi-language transcription
  • Terminal session recording
  • Custom voice command aliases