cardputer-buddy

Deploy MicroPython app files to a Cardputer over USB-serial.

1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Leap0920/Clean-Portfolio --skill cardputer-buddy-leap0920
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: cardputer-buddy
Source: https://github.com/Leap0920/Clean-Portfolio/tree/main/%25USERPROFILE%25/.openclaude/plugins/marketplaces/claude-plugins-official/plugins/cwc-makers/skills/cardputer-buddy
Command: npx skills add https://github.com/Leap0920/Clean-Portfolio --skill cardputer-buddy-leap0920

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the slow cycle of re-flashing and trial-and-error when you want to add or update apps on a provisioned Cardputer MicroPython bundle without disrupting the device setup.

Core Features & Use Cases

  • Add apps via /flash/apps/: Drop new .py files into the device’s apps/ area so main.py automatically exposes them as menu entries on next boot.
  • Push single file changes without re-flashing: Iterate by transmitting only the modified .py content over USB-serial and keep device state intact.
  • Diagnose with serial logs and run one-shot commands: Tail device serial output or execute a one-shot REPL script to verify filesystem contents and behavior after changes.
  • Use case: When you’re improving snake.py gameplay or adding a new BLE client app (like claude_buddy.py), push only the changed file, then watch the serial output to confirm the app loads correctly.

Quick Start

Use the command "python3 onboard/scripts/install_apps.py --port <PORT> --src buddy" to push your new app files from the buddy bundle clone to the already-provisioned device.

Frequently Asked Questions about cardputer-buddy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I push MicroPython app updates to a Cardputer without re-flashing the firmware?▼

Push single .py file changes to the Cardputer’s /flash/apps directory over USB-serial using the provided install_apps.py script, which transmits only the modified file and keeps the existing device state intact without re-flashing.

What is the best way to debug a MicroPython app on the Cardputer after pushing an update?▼

Tail the USB-serial output logs to verify filesystem contents and confirm the app loads correctly, or execute a one-shot REPL script to check runtime behavior after pushing the update.

Can I add new apps to my Cardputer MicroPython bundle without disrupting the existing device setup?▼

Yes, you can add new apps by dropping .py files into the device’s /flash/apps directory using the install_apps.py script, allowing main.py to automatically expose them as menu entries on the next boot without disrupting the setup.

Do I need to run detect.py to connect to my Cardputer for serial workflows?▼

Yes, you need to run detect.py to identify the provided serial port, which is required for connecting to the provisioned Cardputer and executing the USB-serial install scripts and one-shot REPL commands.

Why does my MicroPython app not appear on the Cardputer menu after deployment?▼

A MicroPython app might not appear on the Cardputer menu if the .py file was not correctly placed in the /flash/apps directory, because main.py automatically exposes files as menu entries only on the next boot.