Skip to main content
skill Claude Code official · Anthropic

cardputer-buddy — Claude Code skill: what it does, how to install

Iterate on Cardputer-Adv MicroPython apps without re-flashing. The skill pushes individual files over serial, streams device logs, and runs one-shot REPL commands.

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin install cwc-makers@claude-plugins-official
Open on GitHub

What cardputer-buddy does

This skill manages the buddy/ MicroPython payload for Cardputer-Adv inside the local build-with-claude clone. The device must already be provisioned with m5-onboard. At boot time, main.py scans /flash/apps/ and automatically lists every .py file as a launcher menu option.

Instead of re-flashing firmware, you push modified files using buddy/scripts/push.py. The dev loop also provides tail_serial.py to inspect live hardware output and repl_run.py to evaluate one-off MicroPython commands directly on /flash/. New apps follow the conventions of buddy/device/apps/hello_cardputer.py.

Install this if you develop software for Cardputer and want a fast edit-push cycle. You will need your active USB-serial port name, such as /dev/ttyACM0 or COM3.

What it helps with

  • push changed MicroPython files to Cardputer without re-flashing
  • stream live serial logs directly from the connected device
  • execute one-shot test commands in the MicroPython REPL
  • add new applications to the Cardputer boot menu

Example prompts for the agent

  • push to the cardputer apps/snake.py
  • tail the device
  • run on the device import os; print(os.listdir('/flash'))

How to install cardputer-buddy

1Plugin marketplace

/plugin install cwc-makers@claude-plugins-official

This installs the whole cwc-makers plugin with all its skills

2Skills CLI (Vercel)

npx skills add anthropics/claude-plugins-official --skill cardputer-buddy -a claude-code

3Manually: put the files in place

~/.claude/skills/cardputer-buddy/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cardputer-buddy/

From the same set37

The whole set →
code-reviewer official Anthropic Reviews code changes against CLAUDE.md project rules and flags material defects. Run it before a commit or pull request. Claude Code 31,050installs code-reviewer official Anthropic This subagent checks code changes for bugs, security issues, and project-rule violations. Use it when a review should focus on findings that matter. Claude Code 31,050installs claude-md-improver official Anthropic This skill audits CLAUDE.md files, produces a quality report, and suggests focused edits. Use it when project instructions need a careful review. Claude Code 12,558installs security-auditor official Anthropic This subagent searches code for security flaws and gives engineers concrete fixes. Use it to review a project before hardening or modernization work. Claude Code 10,718installs test-engineer official Anthropic This subagent captures legacy behavior in tests and compares it with a rewritten implementation. Use it before changing existing modules. Claude Code 9,715installs claude-automation-recommender official Anthropic Analyzes a codebase and recommends Claude Code hooks, subagents, skills, plugins, and MCP servers. Useful when setting up a project or refining an existing workflow. Claude Code 9,057installs playground official Anthropic Builds interactive HTML playgrounds with controls, a live preview, and a generated prompt. Use it when a topic is easier to explore visually than through plain text. Claude Code 7,967installs agent-development official Anthropic This skill guides you through creating agents for Claude Code plugins, from trigger conditions to system prompts and tool access. Use it when adding a subagent to a plugin. Claude Code 7,353installs

Similar

flutter-implement-json-serialization flutter Teaches coding agents to build Dart models with fromJson and toJson methods using dart:convert. Useful for manual JSON mapping in simple Flutter data structures. Claude Code CX Codex Cursor +1 37,200installs mentoring-juniors official github This skill mentors junior developers through questions instead of ready-made answers. Use it for learning code, debugging, and getting started with Copilot. GitHub Copilot 6,900installs async-python-patterns Seth Hobson This skill guides async Python work with asyncio, async/await, and concurrent tasks. Use it for APIs and applications with many I/O-bound operations. Claude Code CX Codex Cursor 18,055installs godot-gdscript-patterns Seth Hobson A skill for building Godot 4.x games with GDScript, covering scenes, signals, state management, and architecture. Useful when implementing game systems. Claude Code CX Codex Cursor 17,396installs python-code-style Seth Hobson A skill for Python style rules, linting, formatting, naming, and documentation. Use it when writing code, reviewing changes, or setting project standards. Claude Code CX Codex Cursor 16,456installs ccxt-python ccxt Helps Python developers integrate cryptocurrency exchanges using CCXT. Covers REST and WebSocket endpoints in both synchronous and asyncio modes. Claude Code CX Codex Cursor +1 2,000installs migrate-to-shoehorn Matt Pocock Replaces as type assertions in tests with helpers from @total-typescript/shoehorn. Use it when tests need partial objects or deliberately invalid data. Claude Code 475,388installs write-swift emilkowalski This skill guides Swift coding, reviews, and migrations using the language’s current practices. Use it to investigate concurrency errors, hangs, data races, or retain cycles. Claude Code CX Codex Cursor +1 117,500installs

Questions about cardputer-buddy

How do I install cardputer-buddy in Claude Code?

Run /plugin install cwc-makers@claude-plugins-official in Claude Code, or install it using npx skills add anthropics/claude-plugins-official --skill cardputer-buddy -a claude-code.

What does cardputer-buddy do?

It manages USB-serial workflows for Cardputer-Adv: pushing single files, reading serial logs, and running one-shot MicroPython snippets.

How does Cardputer detect new apps?

The on-device main.py scans the /flash/apps/ folder on boot and lists every .py file as an executable menu entry.

Source text

SKILL.md · Apache-2.0
---
name: cardputer-buddy
description: 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.
---

# 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'))"
```

© Anthropic · Apache-2.0 · anthropics/claude-plugins-official

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor