ramarivera/coding-buddy

解決する問題

Coding Buddy は、Claude Code、Pi、Oh My Pi などの AI コーディングアシスタント向けに、永続的でアニメーション付きの ASCII コンパニオンを提供します。このプロジェクトは、Claude Code から削除された「バディ」機能を復元し、バイナリパッチではなく Model Context Protocol (MCP) を使用することで、ソフトウェア更新後もコンパニオンが生存することを保証します。

動作方法

このプロジェクトは、いくつかの安定した拡張ポイントを通じて AI ハンズオンと統合されます：

• MCP Server：AI にターンの終了時に反応をトリガーするように指示するツールとシステムプロンプトを提供。
• スキル：/buddy のようなスラッシュコマンドを実装し、統計の表示やコンパニオンとのインタラクションを可能に。
• ステータスライン：ターミナルのステータスラインにアニメーション付き ASCII アートと会話吹き出しをレンダリング。
• フック：エラーまたはテスト失敗などのイベントを検出するためにシェルラッパーを使用し、特定のバディ反応をトリガー。

コンパニオンのアイデンティティは、ユーザーのアカウント UUID をもとに決定論的アルゴリズム（wyhash + mulberry32）で生成され、同じユーザーに常に同じバディが割り当てられます。

対象ユーザー

Claude Code、Pi、または Oh My Pi を使用し、ゲーム化された視覚的コンパニオンをコーディングセッションに求めている開発者。

特徴

• 更新に強い：MCP に基づいているため、ホスト AI ツールの更新時でも壊れない。
• 多様な仲間：19種類の異なる種族とレアリティ（共通〜伝説）があり、それぞれ独自の統計（デバッグ、忍耐、混沌、知恵、皮肉）を持つ。
• 事前定義されたフォールバック：AI モデルが反応できなくても、会話吹き出しは常に音声を発するよう、フォールバック用のラインプールを使用。
• ハッチ間同期：環境変数を通じて、異なる AI コーディングツール間で単一のバディアイデンティティを共有するオプションサポート。
• TUIピッカー：特定のバディ種族やレアリティを検索・保存できるインタラクティブなターミナルユーザーインターフェース。