type: user

role: user

content: Fetch the README for https://github.com/anthropics/claude-desktop-buddy via WebFetch at https://raw.githubusercontent.com/anthropics/claude-desktop-buddy/main/README.md. Return the full README content. Research only — do not write any files.

userType: external

entrypoint: sdk-ts

gitBranch: HEAD

slug: mellow-wobbling-swan


type: attachment


type: message

role: assistant

type: text

text: I'll fetch the README for you using WebFetch.

service_tier: standard

attributionAgent: Explore

type: assistant


ToolSearch

query: select:WebFetch

type: direct

speed: standard


tool_name: WebFetch


text: I'll fetch the README content for you.


WebFetch

prompt: Return the full README content


content:
# claude-desktop-buddy README

## Overview
This project enables ESP32-based hardware devices to connect with Claude on macOS and Windows via Bluetooth Low Energy (BLE). The example implementation is a desk pet that responds to Claude interactions, displaying permission prompts and reacting to user activity.

## Hardware & Setup
The firmware targets ESP32 using the Arduino framework, specifically designed for the M5StickC Plus board. Installation requires PlatformIO Core, with straightforward flashing via `pio run -t upload`. Users can reset devices through the settings menu or by holding button A.

## Pairing Process
Developers must enable developer mode in Claude, then access the Hardware Buddy window through the Developer menu. After selecting a device, macOS requests Bluetooth permission. The bridge automatically reconnects when both the app and device are active.

## Device Controls
The three-button interface adapts based on context—normal browsing, pet interaction, information display, or approval prompts. Button A navigates screens and approves actions, Button B scrolls content and denies requests. Holding Button A opens a menu, while shaking creates a "dizzy" animation and lying face-down triggers a nap mode.

## Pet Customization
The device features eighteen ASCII pets with seven animations each, selectable via menu. Users can also create custom GIF characters by dragging a folder containing a `manifest.json` and state-specific GIF files (96px wide) into the Hardware Buddy window.

## Technical Implementation
The project uses Nordic UART Service UUIDs over BLE, with folder push transport for character delivery. Complete wire protocol specifications are available in REFERENCE.md for developers building their own devices.


text:
Here's the full README content for the claude-desktop-buddy project:

## Overview
This project enables ESP32-based hardware devices to connect with Claude on macOS and Windows via Bluetooth Low Energy (BLE). The example implementation is a desk pet that responds to Claude interactions, displaying permission prompts and reacting to user activity.

## Hardware & Setup
The firmware targets ESP32 using the Arduino framework, specifically designed for the M5StickC Plus board. Installation requires PlatformIO Core, with straightforward flashing via `pio run -t upload`. Users can reset devices through the settings menu or by holding button A.

## Pairing Process
Developers must enable developer mode in Claude, then access the Hardware Buddy window through the Developer menu. After selecting a device, macOS requests Bluetooth permission. The bridge automatically reconnects when both the app and device are active.

## Device Controls
The three-button interface adapts based on context—normal browsing, pet interaction, information display, or approval prompts. Button A navigates screens and approves actions, Button B scrolls content and denies requests. Holding Button A opens a menu, while shaking creates a "dizzy" animation and lying face-down triggers a nap mode.

## Pet Customization
The device features eighteen ASCII pets with seven animations each, selectable via menu. Users can also create custom GIF characters by dragging a folder containing a `manifest.json` and state-specific GIF files (96px wide) into the Hardware Buddy window.

## Technical Implementation
The project uses Nordic UART Service UUIDs over BLE, with folder push transport for character delivery. Complete wire protocol specifications are available in REFERENCE.md for developers building their own devices.