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.