スキルOfficialproductivity

📱cardputer-buddy

プラグイン: cwc-makers
ソース: GitHub で見る ↗

説明

次のような場合に使用: ユーザーが新しいアプリを追加したい場合、再フラッシュなしに変更した単一の `.py` ファイルをプッシュしたい場合、デバイスのシリアルログを監視したい場合、またはワンショットの REPL コマンドを実行したい場合。「add an app」「push to the cardputer」「tail the device」「run on the device」というフレーズ、あるいは `/maker-setup` 実行後のフォローアップ作業をトリガーとして起動します。対象は、`m5-onboard` によってすでにプロビジョニング済みの Cardputer-Adv MicroPython アプリバンドル（Claude Buddy、Snake、Hello）に対するイテレーション作業です。

原文を表示

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.

ユースケース

✓新しいアプリを追加したい
✓単一の.pyファイルを再フラッシュなしにプッシュしたい
✓デバイスのシリアルログを監視したい
✓ワンショットのREPLコマンドを実行したい
✓/maker-setup実行後のフォローアップ作業を行う

本文（日本語訳）

Cardputer Buddy アプリバンドル

ローカルの build-with-claude クローン内にある buddy/ ディレクトリは、m5-onboard が /flash/ にインストールする MicroPython ペイロードです。作業はそのクローン内で行ってください。

デバイスのレイアウト

/flash/
├── main.py              ランチャーメニュー（UIFlow のブートフローを置き換え）
├── buddy_*.py           共有ライブラリ（BLE、UI、状態管理、プロトコル、文字セット）
├── burst_frames.py      スプライトフレーム
└── apps/
    ├── claude_buddy.py  BLE クライアント → Claude Desktop の Hardware Buddy
    ├── hello_cardputer.py
    └── snake.py

main.py は起動時に /flash/apps/ をスキャンし、すべての .py ファイルをメニュー項目として一覧表示します。 buddy/device/apps/ にファイルを追加してプッシュすれば、次回起動時にメニューへ反映されます。

アプリの追加方法

buddy/device/apps/hello_cardputer.py を参考にしてください。これはキーボードポーリング・フォント・終了規約の最小構成サンプルです。再フラッシュ不要で、以下のコマンドでプッシュできます：

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

<PORT> は直前の detect.py 実行で報告されたポート名です（例：/dev/cu.usbmodem1101、/dev/ttyACM0、COM3）。

開発ループツール（`buddy/scripts/`）

# USB シリアル経由で一部のファイルをプッシュ
python3 buddy/scripts/push.py --port <PORT> --files apps/snake.py

# デバイスログを監視
python3 buddy/scripts/tail_serial.py --port <PORT>

# REPL への単発コマンド実行
python3 buddy/scripts/repl_run.py --port <PORT> --script "import os; print(os.listdir('/flash'))"

原文（English）を表示

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:

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/`)

# 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 および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。