跳到主要内容

How to Update VibeKeys Max for Windows, Codex, and Firmware v0.3.1

· 阅读需 5 分钟
VibeKeys Team
VibeKeys Team
VibeKeys Team

VibeKeys Max now works better across Windows, Codex, and day-to-day key handling. This update covers three pieces: Vibetty, the remote terminal bridge; VibeKeys app, the desktop configuration tool; and firmware, the software running on the device itself.

This update improves all three:

  • Vibetty now runs on Windows, so remote control and voice-driven terminal workflows are no longer limited to macOS and Linux.
  • VibeKeys app adds Codex support, including Codex hook mode and a Codex keymap profile for keyboard mode.
  • VibeKeys firmware v0.3.1 fixes the default MIC key mapping and improves key release handling on the device.

If you already have a VibeKeys Max, we recommend updating both the desktop software and the device firmware.

Update links:

Windows support in Vibetty​

Vibetty is the local bridge for VibeKeys Max remote control mode. Vibetty v0.3.3 adds Windows support through ConPTY, and the release includes pre-built binaries for:

  • vibetty-windows-x64.exe
  • vibetty-macos-arm64
  • vibetty-linux-x64

This matters for remote control mode. VibeKeys Max should work with the machine you actually code on, whether that is Windows, macOS, or Linux. With this release, the same voice-driven terminal workflow can run across all three platforms.

On Windows, download vibetty-windows-x64.exe from the release page and run it from PowerShell or Command Prompt with your coding agent command, for example:

.\vibetty-windows-x64.exe -- codex

On macOS or Linux, download the matching binary from the same release and run it with your preferred agent:

./vibetty-macos-arm64 -- claude
# or
./vibetty-linux-x64 -- codex

Codex support in the VibeKeys app​

The VibeKeys app v0.1.9 adds Codex and Claude keymap profiles. The release includes:

  • vibekeys-windows-x64.exe
  • vibekeys-macos-arm64
  • vibekeys-linux-x64

After downloading the VibeKeys app for your platform, install or rename the binary as vibekeys, then check that it runs:

vibekeys --help

The app's Hook Mode reads hook JSON events from stdin and forwards them to the VibeKeys Max display. For Codex hook events, run:

vibekeys codex

To switch the keyboard to a Codex-focused keymap profile, run:

vibekeys profile codex

The codex profile maps CUSTOM to /review + Enter and YOLO to y, so review and approval become physical actions. If you switch back to Claude Code, run:

vibekeys profile claude

Only the CUSTOM and YOLO keys are changed by these profiles, so switching between Codex and Claude Code stays predictable.

Firmware v0.3.1​

The firmware update from v0.3.0 to v0.3.1 focuses on device reliability:

  • fixes the default MIC key mapping
  • fixes a case where a key release event could be missed during screen refresh
  • bumps the firmware version to v0.3.1

The key release fix is especially important for a physical controller. If the display refreshes while you press and release a key, the firmware now handles that state more reliably.

How to update VibeKeys Max​

This update has three parts: update the VibeKeys app, update Vibetty if you use remote control mode, and update the firmware on the device.

1. Update the VibeKeys app​

Download VibeKeys app v0.1.9 for your platform:

  • vibekeys-windows-x64.exe for Windows
  • vibekeys-macos-arm64 for Apple Silicon Macs
  • vibekeys-linux-x64 for Linux x64

This is the tool you use for keyboard configuration, Codex profiles, ASR settings, WiFi settings, and BLE control in keyboard mode. After updating it, check that it runs:

vibekeys --help

2. Update Vibetty​

If you use VibeKeys Max in remote control mode, download Vibetty v0.3.3:

  • vibetty-windows-x64.exe for Windows
  • vibetty-macos-arm64 for Apple Silicon Macs
  • vibetty-linux-x64 for Linux x64

This is the tool that runs the local terminal bridge for Claude Code, Codex, or another terminal program.

3. Update the firmware​

Firmware updates happen on the VibeKeys Max device itself. There are two supported methods:

  • OTA update: recommended if your device is working and can connect to WiFi.
  • ESP LaunchPad: use this for recovery, factory reset, or when OTA does not work.

Follow the full firmware guide here: Updating VibeKeys Firmware.

Why this update matters​

This update makes VibeKeys less tied to one operating system and one coding agent. Vibetty now reaches Windows users. VibeKeys app now understands Codex workflows. Firmware v0.3.1 improves the physical key behavior on the device itself.

That is the direction for VibeKeys: the repetitive parts of AI coding should become physical, fast, and easy to reach, whether you are using Claude Code, Codex, macOS, Linux, or Windows.