Customize Key Mappings

VibeKeys Max has 7 programmable keys that you can remap to any keyboard shortcut, modifier combo, or text macro using the vibekeys CLI tool.

Prerequisites

• VibeKeys Max paired via Bluetooth (see Keyboard Mode)
• vibekeys CLI installed (see Claude Code Status Integration)

Default Programmable Keys

VibeKeys Max has 7 programmable keys. Their mappings depend on the active profile. The two built-in profiles differ only on CUSTOM and YOLO — the other five keys are the same in both:

Key Name	Symbol	Claude Code (profile claude)	Codex (profile codex)
MIC	🎙️	Left CTRL + SHIFT	Left CTRL + SHIFT
CUSTOM	🌟	/compact + Enter	/review + Enter
ESC	ESC	Escape	Escape
NEXT	⬇️	Page Down	Page Down
BACKSPACE	⬅️	Delete	Delete
YOLO	YOLO	Shift + Tab	y
ACCEPT	Accept	Enter	Enter

Apply a profile with vibekeys profile claude or vibekeys profile codex (see Keymap Profiles below), or remap any key individually as shown next.

Basic Usage

vibekeys keymap <KEY> <BINDING>

The CLI connects to your VibeKeys Max over Bluetooth, sends the new mapping, and the device stores it. Mappings are merged -- you can set them one at a time and they accumulate on the device.

Binding Types

Single Key

Map a key to a single keystroke:

vibekeys keymap ESC A
vibekeys keymap CUSTOM Enter
vibekeys keymap ACCEPT Space

Modifier Combos

Combine modifiers with a key using +:

vibekeys keymap ESC Ctrl+C
vibekeys keymap MIC Shift+Alt+Delete
vibekeys keymap CUSTOM Ctrl+Shift+T
vibekeys keymap ACCEPT Cmd+S

Supported modifiers:

Modifier	Aliases
Ctrl
Alt	Option
Shift
Meta	Win, Cmd, Command, GUI

Text Macros

Send a string of text by quoting it:

vibekeys keymap CUSTOM '"hello world"'
vibekeys keymap MIC '"git status\n"'

Text macros support escape sequences:

• \n -- newline (press Enter)
• \t -- tab
• \xNN -- hex byte

Keymap Profiles

Requires vibekeys CLI v0.1.9+

Keymap profiles need the vibekeys CLI at v0.1.9 or later. Check with vibekeys --version and grab the latest release if you're behind.

A profile applies a set of key mappings in one command, so you can switch the keypad between AI coding tools instantly:

vibekeys profile codex     # map CUSTOM → /review and YOLO → y (approve)
vibekeys profile claude    # map CUSTOM → /compact and YOLO → Shift+Tab

On success, a confirmation prints to your terminal and shows on the VibeKeys Max screen (✨ You're with Codex now / ✨ You're with Claude Code now).

Related Docs

• Keyboard Mode - Getting started with keyboard mode
• Claude Code Status Integration - Install the vibekeys CLI
• Buttons And Keys - Default key reference