Skill44k repo starsupdated 4d ago

cardputer-buddy

Cardputer Buddy manages iterative development of MicroPython apps on an M5 Cardputer device after initial provisioning. Use it to add new apps to the device menu, push individual changed Python files without reflashing, monitor device serial output, or execute commands via REPL. The bundle includes Claude Buddy (BLE client to Claude Desktop), Snake, and Hello apps that users can modify or extend.

View source Repository: claude-plugins-official

Install in Claude Code

Copy

git clone --depth 1 https://github.com/anthropics/claude-plugins-official /tmp/cardputer-buddy && cp -r /tmp/cardputer-buddy/plugins/cwc-makers/skills/cardputer-buddy ~/.claude/skills/cardputer-buddy

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Cardputer Buddy app bundle

The `buddy/` directory in the local `build-with-claude` clone is the MicroPython payload that `m5-onboard` installs onto `/flash/`. Work inside that clone.

## Device layout

```
/flash/
├── main.py              launcher menu (replaces UIFlow's boot flow)
├── buddy_*.py           shared libs (BLE, UI, state, protocol, chars)
├── burst_frames.py      sprite frames
└── apps/
    ├── claude_buddy.py  BLE client → Claude Desktop's Hardware Buddy
    ├── hello_cardputer.py
    └── snake.py
```

`main.py` scans `/flash/apps/` at boot and lists every `.py` as a menu entry. Drop a file into `buddy/device/apps/`, push it, and it appears on next boot.

## Adding an app

Crib from `buddy/device/apps/hello_cardputer.py` — smallest example of keyboard polling, font, and exit conventions. Then push without re-flashing:

```bash
python3 onboard/scripts/install_apps.py --port <PORT> --src buddy
```

`<PORT>` is whatever `detect.py` reported last run (e.g. `/dev/cu.usbmodem1101`, `/dev/ttyACM0`, `COM3`).

## Dev loop tooling (`buddy/scripts/`)

```bash
# Push a subset of files over USB-serial
python3 buddy/scripts/push.py --port <PORT> --files apps/snake.py

# Watch device logs
python3 buddy/scripts/tail_serial.py --port <PORT>

# One-shot REPL exec
python3 buddy/scripts/repl_run.py --port <PORT> --script "import os; print(os.listdir('/flash'))"
```