Skip to main content

Codex Status Integration

Display real-time status from OpenAI Codex directly on your VibeKeys Max screen while in keyboard mode.

When enabled, your VibeKeys Max screen shows live updates from Codex, letting you see what it's working on without looking at your monitor.

What You'll Need​

Prerequisites
  • VibeKeys Max connected in keyboard mode
  • Codex installed and running
  • vibekeys CLI tool
  • vibekeys plugin installed in Codex
  • A terminal running Codex with access to your computer's Bluetooth

Step 1: Install VibeKeys CLI​

The vibekeys CLI is the bridge between Codex and your VibeKeys Max device.

macOS with M chip​

curl -LO https://github.com/second-state/vibekeys_app/releases/latest/download/vibekeys-macos-arm64
chmod +x vibekeys-macos-arm64
sudo mv vibekeys-macos-arm64 /usr/local/bin/vibekeys

Windows​

Invoke-WebRequest -Uri "https://github.com/second-state/vibekeys_app/releases/latest/download/vibekeys-windows-x64.exe" -OutFile "vibekeys.exe"
# Add to PATH or move to a directory in PATH

Linux​

wget https://github.com/second-state/vibekeys_app/releases/latest/download/vibekeys-linux-x64
chmod +x vibekeys-linux-x64
sudo mv vibekeys-linux-x64 /usr/local/bin/vibekeys

After installation, verify:

vibekeys --version

Step 2: Install the VibeKeys Plugin in Codex​

Add the Second State marketplace, then install the plugin:

codex plugin marketplace add second-state/marketplace
codex plugin add vibekeys@second-state-tools

Restart Codex after installation so the plugin is loaded in the next session.

Verify the plugin is installed:

codex plugin list

Look for vibekeys in the installed plugin list. Then send a test message to confirm the device is reachable:

vibekeys send "Hello World"

If everything goes well, you'll see "Hello World" on your VibeKeys Max screen.

Step 3: Set the Keys Up for Codex​

To match the physical keys to the Codex workflow, apply the codex profile:

vibekeys profile codex
Requires vibekeys CLI v0.1.9+

Keymap profiles need the vibekeys CLI at v0.1.9 or later. Run vibekeys --version to check, and grab the latest release if you're behind.

This maps CUSTOM to /review (one-key code review) and YOLO to y (approve). Run vibekeys profile claude to switch back. See Customize Key Mappings for details.

Step 4: Start Coding​

Once the test succeeds, your VibeKeys Max screen will automatically display status updates when you use Codex:

  • Current Codex operation (generating, thinking, running a tool, etc.)
    • User query
    • Whether the work is finished
    • Waiting for your input

The screen updates automatically as Codex works, no additional configuration needed.