# anthropics/claude-desktop-buddy

Reference and an example for the Bluetooth API for makers in Claude Cowork & Claude Code Desktop

Repository: https://github.com/anthropics/claude-desktop-buddy
Canonical: https://ross.abutalabs.com/products/claude-desktop-buddy
Language: C++
License: NOASSERTION
License Family: other
Last push: 2026-04-16T23:25:07+00:00

## Health v2 (maintenance only)
Score: 49/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 77, release rhythm 35, longevity 10
- inputs: {"age_days": 146, "days_push": 139, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, young, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2551, forks 449 (observed 2026-08-28T04:07:00.555773+00:00)

## What it is
A reference implementation and example firmware for the Bluetooth (BLE) maker API in Claude Cowork and Claude Code Desktop, including an ESP32 desk-pet device that shows permission prompts and lets users approve or deny them from hardware. It documents the wire protocol (Nordic UART Service UUIDs, JSON schemas, folder push transport) so makers can build their own compatible devices.

## Use cases
- build custom hardware that displays Claude permission prompts
- approve or deny Claude agent actions from a physical device
- learn the BLE wire protocol for Claude desktop integrations
- flash example firmware onto an M5StickC Plus or ESP32
- create a desk pet that reacts to Claude session activity
- integrate maker devices with Claude Code over Bluetooth

## When to choose
- you want to build custom hardware that integrates with Claude desktop apps over BLE
- you need the authoritative wire protocol reference for the Claude maker Bluetooth API
- you have an M5StickC Plus or compatible ESP32 board and want a working example
- you want physical approve/deny controls for Claude agent permission prompts

## When to avoid
- you need a general-purpose BLE library unrelated to Claude
- your hardware is not ESP32-based and you cannot port the display/button drivers
- you want a polished consumer product rather than a reference example
- you need integration with Claude on platforms other than macOS or Windows

## Facets
- artifact type: library
- maturity: active
- function: embedded, sdk, developer-tools, documentation
- domain: hardware, developer-tools, iot, artificial-intelligence
- platform: embedded, windows, cpp
- tags: bluetooth, ble, esp32, firmware, maker, claude, nordic-uart-service, reference-implementation, macos

## Member repositories
- anthropics/claude-desktop-buddy (main) score 49

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:00.555773+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:23:53.732360+00:00, confidence not recorded.
  - readme: https://github.com/anthropics/claude-desktop-buddy (fetched 2026-08-28T04:07:00.555773+00:00, sha 07136d7bfac9)
- Data as of 2026-08-30T08:39:29.467469+00:00.