ntd4996/agentpet

AgentPet – AIコーディングエージェントを監視するデスクトップコンパニオン

何であるか – AgentPetは、無料でオープンソースのデスクトップアプリ（macOS、Windows、Linux）であり、メニューに常駐し、実行中のAIコーディングエージェント（Claude Code、Codex、Gemini、Cursorなど）のリアルタイム状態を表示します。同時に、スクリーン上を浮かぶ小さなアニメーション「ペット」が、トークンの消費やセッションの完了に応じて経験値を獲得し、進化していきます。コア機能は完全にオフラインで動作；GitHubでログインすることで、オプションのWeb同期、パブリックリーダーボード、複数デバイス間の復元が利用可能になります。

主な機能

• マルチエージェントモニター – メニューバーに色分けされたステータスドット、プロジェクト名、エージェントの現在の動作、リアルタイムタイマーを表示。トレイアイコンは、いずれかのエージェントが入力を必要としているときにオレンジ色に変わります。
• デスクトップペット（タマゴッチ風） – ペットはエージェントが消費するトークンと完了したセッションを「食べる」ことで経験値（XP）を獲得し、5段階のレベルアップを経て14のアチーブメントを解放します。ペットを右クリックすると、レベル、空腹度、7日間の消費チャート、リアルタイムのClaude/Codexサブスクリプション制限を表示するHUDが表示されます。
• プロジェクトごとのペットと使用状況ダッシュボード – フォルダにペットを割り当て可能。ダッシュボードはプロジェクト別・エージェント別にトークン使用量を分解表示（日次／月次チャート）。過去90日分の履歴はローカルに保存されます。
• オプションのオンラインプロフィール – GitHubでログインすると、ペットを公開し、コミュニティリーダーボードに掲載され、複数マシン間で進捗を同期できます。データは、明示的に許可しない限り、あなたのコンピュータから送出されません。
• 拡張可能なエージェント対応 – 11種類のエージェントが事前設定済み。任意のコマンドラインツールは agentpet run -- <command> でラップ可能です。
• カスタムペットパック – ペットはオープンな Codex pet-pack 形式（pet.json + スプライトシート）に従います。ユーザーはWebギャラリーからパックを閲覧・採用、または自作パックを提出できます。

対応プラットフォーム

• macOS 13+ – ネイティブSwift/SwiftUIアプリ、ノートリゼーション済み、Sparkleによる自動更新。
• Windows 10/11（64ビット） – Tauri（Rust）ビルド、自動更新、ユーザー単位インストール。
• Linux（64ビット） – 同じTauriバイナリをAppImage、.deb、.rpm形式で配布。AppImageではアプリ内自動更新をサポート。

インストール方法

• macOS: brew install --cask ntd4996/tap/agentpet またはGitHubリリースページから署名済み.dmgをダウンロード。
• Windows: ウェブサイトまたはリリースページからインストーラまたはポータブルzipをダウンロード。
• Linux: AppImage、DEB、RPMをダウンロードするか、curl … | sh 一発コマンドで最新AppImageを取得。
• ソースからのビルド（macOS）にはXcode 16 / Swift 6が必要。Windowsのソースは windows/ ディレクトリにあります（Tauri + Rust）。

動作方法

1. 設定 → 一般 で各AIコーディングエージェントのフックをインストール。
2. 通常通りエージェントを実行。AgentPetはUnixソケットデーモン経由でイベントを受信。
3. ペットが画面で反応、メニューバーアイコンが更新され、XP/レベルはローカルに記録。
4. （オプション）GitHubでログインしてペットを同期、Webプロフィールを閲覧、リーダーボードで競い合う。

コミュニティ – ベトナム語、簡体字中国語、繁体字中国語、日本語の翻訳済み。コミュニティメンテナンスのポート（例：Rust + GTK4 Linux版）。ペットはユーザーが貢献し、個別にライセンスされています。アプリ自体はMITライセンスです。

ライセンス – アプリケーションコードはMITライセンス。ペットアセットはリポジトリに含まれず、それぞれの作成者のライセンスに従います。