Cardputer Buddy

by anthropicsb78ac49cdc6bNo license37K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated today

Iterate on the Cardputer-Adv MicroPython app bundle (Claude Buddy, Snake, Hello) after the device is already provisioned via m5-onboard. Use when the user wants to add a new app, push a single changed .py without re-flashing, watch device serial logs, or run a one-shot REPL command. Trigger on "add an app", "push to the cardputer", "tail the device", "run on the device", or follow-up work after /maker-setup.

FeaturedInstructions onlySoftware Development
AI-generated overview

Guides iterating on a Cardputer-Adv MicroPython app bundle: adding apps, pushing files over USB-serial, tailing logs, and running REPL commands.

What it does
This skill documents the layout of a Cardputer-Adv MicroPython payload installed on /flash/, including the launcher main.py, shared buddy_*.py libraries, and the apps directory. It explains how to add a new app by copying the hello_cardputer.py example and pushing it without re-flashing, and it describes helper scripts for pushing selected files, watching device serial logs, and running one-shot REPL commands. The deliverable is guidance and commands for a device development loop rather than a generated file.
When to use it
Use it after a Cardputer-Adv device has already been provisioned with m5-onboard, when the user wants to add a new app, push a single changed .py file without re-flashing, tail device serial logs, or run a one-shot REPL command on the device.
Requirements
Requires an already-provisioned Cardputer-Adv device reachable over USB-serial, a local build-with-claude clone containing the buddy/ directory, Python 3, and the referenced scripts (onboard/scripts/install_apps.py, buddy/scripts/push.py, buddy/scripts/tail_serial.py, buddy/scripts/repl_run.py). The skill itself ships no scripts and is instructions only.

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-serialpython3 buddy/scripts/push.py --port <PORT> --files apps/snake.py
# Watch device logspython3 buddy/scripts/tail_serial.py --port <PORT>
# One-shot REPL execpython3 buddy/scripts/repl_run.py --port <PORT> --script "import os; print(os.listdir('/flash'))"

Source and attribution

Source:anthropics/claude-plugins-officialinplugins/cwc-makers/skills/cardputer-buddyat commitb78ac49

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from anthropics/claude-plugins-official

Skill Development

anthropics

Featured

Guides creation of Claude Code plugin skills, covering structure, descriptions, progressive disclosure and validation.

AI & Agents37Kupdated today

Plugin Structure

anthropics

Featured

Guides the structure, manifest, and component layout of Claude Code plugins.

AI & Agents37Kupdated today

Project Artifact

anthropics

Featured

Generate and publish a project status artifact — an opinionated, tabbed status page for a project too big for one update (overview & success criteria, the workstream sequence, next steps, plus background, plan, risks & open questions, and decisions/FAQ when they earn a tab) — published with the built-in Artifact tool to a default-private claude.ai page the user can share with teammates. Use when a piece of work spans several workstreams and you want a shareable overview kept current. Each artifact is backed by a small per-project config in the plugin data dir, so refreshing it re-gathers live state, redeploys the same URL, and reports only the delta. For software projects whose workstreams are PRs, also read swe.md (the X.Y PR-numbering convention; pulling PR state with gh/git; a per-PR detail block). Needs the built-in Artifact tool (claude.ai login). Not for single-PR changes or public docs.

Awaiting classification37Kupdated today

Command Development

anthropics

Featured

Guides creation of Claude Code slash commands, covering structure, YAML frontmatter, arguments and plugin features.

AI & Agents37Kupdated today

Playground

anthropics

Featured

Builds self-contained interactive HTML playgrounds with controls, live preview, and copyable prompt output.

Design & Creative37Kupdated today

M5 Onboard

anthropics

Featured

Provisions M5Stack ESP32 boards by detecting them on USB, flashing UIFlow 2.0 firmware, and installing a MicroPython app bundle.

DevOps & Cloud37Kupdated today