CC Buddy Bridge

cc-buddy-bridge

English | 简体中文 | 日本語

Bridge Claude Code CLI sessions to the
claude-desktop-buddy BLE
hardware — without going through the Claude desktop app.

The buddy firmware officially pairs with Claude for macOS/Windows. This project
lets you drive the same hardware from a plain terminal running the claude CLI,
so your desk pet reacts to CLI sessions: sleeps when idle, gets busy when a
tool call runs, blinks when a permission prompt needs your attention, and lets
you approve or deny right from the stick's buttons.

What you get

- Physical 2FA for risky tools — set defaultMode: bypassPermissions everywhere except the desk buddy. A/B buttons on the stick decide allow/deny for the few operations you flagged on permissions.ask.
- Smart matcher — auto-allow trivial Bash (ls/cat/grep/...), always-ask risky (rm/curl/git push/...), defer the rest to the stick. TOML-overridable.
- Live stick HUD — assistant replies mirror to the stick within ~500 ms via a JSONL tailer (no Stop-hook flush race).
- Statusline — cc-buddy-bridge hud renders battery / encryption / tokens today / estimated USD spend today / pending prompts in your prompt bar; composes with claude-hud.
- One-command install + autostart — cc-buddy-bridge install --service picks the right backend per OS: launchd (macOS), systemd user unit (Linux), Task Scheduler (Windows).
- Custom GIF characters — cc-buddy-bridge push-character ./pack/ uploads a folder of frames over BLE with chunked flow control.
- Release notifications + self-update — daemon pings GitHub releases once a day; hud renders ↑ vX.Y.Z when a newer tag exists. cc-buddy-bridge check-update for a one-off check, cc-buddy-bridge update to actually pull + reinstall + restart the daemon. Opt out of polling with CC_BUDDY_BRIDGE_NO_UPDATE_CHECK=1.
-…