cuiqingwei

Claude Desktop Buddy Bridge — Development skill for Claude Code

Development community

让 M5StickC Plus 成为 Claude Code 的物理审批按钮（CLI 版）.

How to install Claude Desktop Buddy Bridge

This entry records only its repository, not the path inside it, so there is no exact command to give. Open cuiqingwei/claude-desktop-buddy-bridge and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Desktop Buddy Bridge does

让 M5StickC Plus 成为 Claude Code 的物理审批按钮（CLI 版）.

Alternatives in Development

Claude Desktop Buddy — Reference and an example for the Bluetooth API for makers in Claude Cowork & Claude Code Desktop 2.5k ★
Claude Keysmith — Managed Claude Code instruction deployment with safe CLI recovery and an unsigned macOS/Windows desktop beta 696 ★
/sync-agents-md - Regenerate AGENTS.md From CLAUDE.md — Synchronize AGENTS.md with current CLAUDE.md using the codex-cli-bridge skill 618 ★

README

claude-desktop-buddy-bridge

用一块实体小屏幕，按键审批 Claude Code CLI 的每一次敏感操作。

[![Python 3.11+](https://img.shields.io/badge/python-3.11+-orange.svg)](https://www.python.org/) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![uv](https://img.shields.io/badge/package_manager-uv-purple.svg)](https://github.com/astral-sh/uv)

Anthropic 的官方 [claude-desktop-buddy](https://github.com/anthropics/claude-desktop-buddy) 固件让 M5StickC Plus 变成 Claude 的物理审批按钮——但它只与**桌面应用**通信，CLI 用户无缘使用。

**claude-desktop-buddy-bridge** 填补这个空缺：一个轻量 Python 守护进程，通过 Claude Code 原生 Hook 系统拦截工具调用，经由 BLE NUS 协议与设备通信，让你用手边的硬件按键来 approve / deny，而不是盯着终端敲 y。

flowchart TD
    A["**Claude Code CLI**\nPermissionRequest 钩子"]
    B["**cdbb 守护进程**"]
    C["**M5StickC Plus**"]
    D["**按键决策**\n批准或中止"]
    E["**继续执行**"]
    F["**中止任务**"]

    A --> B
    B -->|"BLE（NUS）"| C
    C --> D
    D -->|"决策结果"| B
    B --> E
    B --> F

功能

零侵入：通过 Claude Code 原生 Hook 接入，不需要修改任何项目文件
Fail-open：守护进程未运行时，CC 自动回退到自己的权限对话框
自动扫描：无需手动查找设备地址，自动发现广播名以 Claude 开头的设备
中文安全：所有发往设备的字符串自动 sanitize，避免固件点阵字体索引越界崩溃
并发串行：多个并发 hook 请求排队，不会同时争抢设备
EOF 竞争检测：若 CC 提前终止 hook 进程，立即清空设备显示，不会傻等超时
心跳自愈：BLE 链路断开后连续失败退出，由 launchd/systemd 自动重启

硬件要求

M5StickC Plus，烧录 Anthropic 官方 claude-desktop-buddy 固件
macOS（已测试）或 Linux（需额外蓝牙权限配置，见下文）

快速开始

1. 烧录固件

git clone https://github.com/anthropics/claude-desktop-buddy
cd claude-desktop-buddy
pio run -t erase && pio run -t upload

2. 安装 claude-desktop-buddy-bridge

# 使用 uv（推荐）
uv tool install claude-desktop-buddy-bridge

# 或直接从源码
git clone https://github.com/cuiqingwei/claude-desktop-buddy-bridge
cd claude-desktop-buddy-bridge
uv sync