Skip to main content

Vibetty Now Runs on Windows

· 2 min read
VibeKeys Team
VibeKeys Team
VibeKeys Team

Vibetty is a voice-driven terminal for AI coding agents. You speak into a VibeKeys Max keyboard's built-in microphone, the keyboard streams the audio to the Vibetty server, and your words are transcribed straight into Claude Code (or any terminal program) while the live terminal shows in your browser. Until now it ran on Linux and macOS only. As of this release, Vibetty runs on Windows 10 and 11 too.

What changed​

The hard part of running a terminal app on Windows is the pseudo-terminal (PTY). On Linux and macOS, Vibetty uses a Unix PTY to spawn and talk to the shell. Windows has its own mechanism, ConPTY, and getting it right took two fixes:

  • PTY backend. Vibetty now uses portable-pty-psmux, an API-compatible fork of portable-pty. The published portable-pty 0.9.0 has a known ConPTY bug (wezterm#1396) where the spawned process produces no output and ignores input. The fork ships the upstream fix that was never published to crates.io.
  • Cursor-position report. Windows ConPTY sends an ESC[6n (cursor position request) on startup and stalls until the host replies. Unix shells don't do this, so macOS was never affected. Vibetty's reader thread now answers with ESC[1;1R on the first read, so cmd, PowerShell, and claude start cleanly.

Running on Windows​

Pre-built releases now include a vibetty-windows-x64.exe binary. From PowerShell or Command Prompt:

# Pre-built binary
.\vibetty-windows-x64.exe -- claude

# Or build from source
cargo build --release
.\target\release\vibetty.exe -- claude

Set your ASR config with $env: in PowerShell:

$env:VIBECODE_ASR_API_KEY = "your_api_key_here"
$env:VIBECODE_ASR_URL     = "https://api.groq.com/openai/v1/audio/transcriptions"
.\vibetty.exe -- claude

Then open http://localhost:3000 and start talking to your agent. The full setup, including the interactive vibetty setup wizard and the browser-side WebVosk mode that needs no API key, is in the README.

Why it matters​

Voice-driven AI coding shouldn't depend on your operating system. With Windows support, the same Vibetty workflow now works the same way across Linux, macOS, and Windows, so you can speak to Claude Code from whatever machine you're on.