VibeKeys Max Quick Start
VibeKeys Max is an AI coding keypad built for developers who work with coding assistants such as Claude Code.
Choose Your Mode
VibeKeys Max supports two modes of operation. Choose the one that fits your workflow:
Keyboard Mode (Default)
Best for: Direct input workflows, coding at your desk, real-time status updates from Claude Code.
In keyboard mode, VibeKeys Max acts as a Bluetooth keyboard with custom shortcuts. Connect over Bluetooth and get instant real-time status updates on your device screen.
Features:
- Bluetooth connection (no WiFi needed)
- Real-time Claude Code status on screen
- Keyboard shortcuts and macros
- Optional: Claude Code status integration with plugin
- Great for staying focused at your desk
→ Start with Keyboard Mode
Remote Control Mode
When the device starts up, press the Accept key to enter remote control mode. This requires WiFi and the vibetty server URL to be configured first on the setup page.
Best for: Distance coding, demos, reviews, or hands-free voice control.
In remote control mode, VibeKeys Max connects to your computer over WiFi and lets you drive Claude Code with voice input and physical controls. Use vibetty to bridge your device and Claude Code.
Features:
- WiFi connection
- Voice input for prompts
- Full remote control of Claude Code
- Optional: Vosk for local speech-to-text (no API key needed)
→ See Remote Control Mode to learn more
Identify Your Version
VibeKeys Max has two hardware versions. They share the same software and features — the only difference is the screen size and firmware file.
V1 — wider, squarish screen
V2 — narrower, taller screen
| V1 | V2 | |
|---|---|---|
| Screen | 1.69" (240×280) | 1.47" (172×320) |
| Firmware file | vibekeys_ota.bin | vibekeys_max2.bin |
All other hardware, software, and features are identical between V1 and V2. The only difference is the screen and firmware file.
Demo
Watch this demo to see VibeKeys Max remote control mode in action: