CodeBuddy は何をしますか？
Claude Desktop の承認とセッションモニタリングを StickS3 ハードウェアコンパニオンにオフロードします。
概要
CodeBuddy は、Claude Desktop の承認プロセスとセッション監視を、物理的な StickS3 デバイスに委譲するスキルです。これにより、ユーザーは Claude との対話中に、マウスやキーボードを使わずに操作を続行できます。
機能
- ハンズフリー承認: StickS3 のボタンを使用して、Claude からの提案（コード変更、ファイル操作など）を承認または拒否します。
- セッション状態表示: StickS3 の LCD 画面に、現在のセッション状態（アクティブ、待機中、エラー、完了など）をリアルタイムで表示します。
- カスタマイズ可能なフィードバック: デバイスの LED やサウンド（対応している場合）を使用して、状態変化を通知します。
必要なもの
- ハードウェア: StickS3 デバイス（ESP32-S3 ベースのスティック型マイコン）
- ソフトウェア: Claude Desktop アプリケーション（最新バージョン推奨）
- 接続: USB または Wi-Fi 経由で Claude Desktop と通信します。
セットアップ
- StickS3 の準備: 公式ドキュメント に従い、StickS3 にファームウェアを書き込みます。
- スキルのインストール: Claude Desktop の設定から、このスキル（shier3135/CodeBuddy）を有効にします。
- ペアリング: StickS3 を PC に USB 接続するか、同じネットワーク上の Wi-Fi 経由でペアリングします。
- 動作確認: Claude に簡単なタスクを依頼し、StickS3 のボタンで承認操作ができることを確認します。
使い方
# デバイスのステータスを確認（例: CLI から）
codebuddy status
# 承認待ちのアクションを一覧表示
codebuddy pending
# 特定のアクションを承認
codebuddy approve <action-id>
設定オプション
| 設定項目 | 説明 | デフォルト値 |
|---|---|---|
device_port | StickS3 のシリアルポート | /dev/ttyUSB0 (Linux/macOS) または COM3 (Windows) |
led_brightness | LED の明るさ (0-255) | 128 |
refresh_interval | 状態更新間隔 (秒) | 2 |
注意事項
- デバイスのファームウェアは定期的に更新してください。
- セッション中にデバイスの接続が切れた場合、手動での承認が必要になることがあります。
- このスキルは実験的なものであり、本番環境での使用は推奨されません。
ライセンス
このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。