Panmax

M5stack Claude Code Buddy — Development skill for Claude Code

Development community

Physical companion device for Claude Code using M5StickC PLUS2. Notifies on permission requests via BLE with Allow/Always Allow/Reject buttons.

How to install M5stack Claude Code Buddy

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

What M5stack Claude Code Buddy does

Physical companion device for Claude Code using M5StickC PLUS2. Notifies on permission requests via BLE with Allow/Always Allow/Reject buttons.

Alternatives in Development

  • Analyze Feature Requests — Prioritize feature requests by theme, impact, effort, and risk 7.8k ★
  • Claude Desktop Buddy — Reference and an example for the Bluetooth API for makers in Claude Cowork & Claude Code Desktop 2.5k ★
  • Claude Peers MCP — Allow all your Claude Codes to message each other ad-hoc 1.9k ★

README

M5Stack Claude Code Buddy

A physical companion device for [Claude Code](https://claude.ai/claude-code) built with [M5StickC PLUS2](https://docs.m5stack.com/en/core/M5StickC%20PLUS2). It alerts you when Claude Code needs permission approval and lets you respond (**Allow Once** / **Always Allow** / **Reject**) directly from the device via BLE.

How It Works

Claude Code                    Mac (Python)                  M5StickC PLUS2
    |                              |                              |
    |-- PreToolUse hook fires ---->|                              |
    |                              |-- BLE write (tool info) ---->|
    |                              |                              |-- Buzzer + Screen
    |                              |                              |
    |                              |                              |<- User presses button
    |                              |<-- BLE notify (decision) ----|
    |<-- JSON decision (stdout) ---|                              |
    |                              |                              |
    |-- Allow / Block tool ------->|                              |

When Claude Code wants to run a tool that requires permission, the `PreToolUse` hook sends the request to the M5StickC PLUS2 over Bluetooth Low Energy. The device buzzes, shows the tool name and details on screen, and presents three options. You pick one with the hardware buttons, and the decision flows back to Claude Code instantly.

Demo

 ┌──────────────────────────┐
 │ Tool: Bash               │
 │ git push origin main     │
 │──────────────────────────│
 │ ▶ Allow Once             │  ← Selected (green)
 │   Always Allow           │
 │   Reject                 │
 │──────────────────────────│
 │ [BtnA] Switch  [BtnB] OK │
 └──────────────────────────┘

Hardware

  • M5StickC PLUS2 (~$20)
    • ESP32-PICO-V3-02 (dual-core 240MHz, BLE 4.2)
    • 1.14" TF