OpenVibble

English | 中文

M5Stack dev board still on the way? Start with OpenVibble first.

OpenVibble implements the Claude Desktop Buddy Bluetooth protocol so an iPhone can pair directly with Claude Desktop and stand in for the original M5Stack hardware. Paired with the companion macOS app OpenVibble Desktop, it can also bridge to other agents such as Claude Code.

It builds on Claude Desktop Buddy with iOS-native UX and runtime support.

Screenshots

Claude Desktop Connected	iOS App	Dynamic Island

The buddy runtime stays on your phone with support for:

• BLE pairing with Claude Desktop's Hardware Buddy mode
• Approving or denying prompts directly from the phone
• Persona state transitions (idle / attention / busy / sleep / dizzy / celebrate / heart)
• Motion-based interactions (shake, face-down)
• Built-in and over-the-air GIF character packs
• Dynamic Island and Live Activity status surface with quick actions

Requirements

• macOS with Xcode 17+
• iOS deployment target: 18.0+
• XcodeGen
• A physical iPhone — the iOS Simulator does not support BLE peripheral advertising

Quick Start

make bootstrap
open OpenVibble.xcodeproj

Or build from command line:

make build

Run package tests + app tests:

make test

Pair With Claude Desktop

1. In Claude Desktop, enable Developer mode from Help -> Troubleshooting -> Enable Developer Mode.
2. Open Developer -> Open Hardware Buddy..., click Connect, then pick your iOS device.
3. Launch OpenVibble on your iOS device and grant Bluetooth permission when prompted.

Notes:

• iOS controls BLE/GAP behavior, so some low-level options from MCU firmware are not available.
• Character packs transferred from desktop are saved under app sandbox storage and appear in species/persona pickers automatically.

Pair With Claude Code (via OpenVibble Desktop)

OpenVibble Desktop is a macOS companion app that bridges OpenVibble to Claude Code — and any other agent that speaks the same hook protocol.

1. Build and run OpenVibbleDesktop from the same Xcode workspace.
2. Open the Hooks tab in OpenVibble Desktop and register the Claude Code hooks. This writes into ~/.claude/settings.json and can be removed at any time.
3. Connect your iOS device. Claude Code session events — session start/stop, permission prompts, response completion, user messages — are forwarded to the buddy in real time.

Contributing

Issues and pull requests are welcome. Please include reproducible steps and environment details when reporting bugs.

Localization

The app currently includes English (en) and Simplified Chinese (zh-Hans) resources.

License

Mozilla Public License 2.0. See LICENSE.