crafter-station/petdex：Codex向けアニメペットのギャラリーとCLI

ギャラリー・CLI・デスクトップの三層構成

crafter-station/petdex（Petdex）は、Codex、Claude Code、OpenCode、Gemini CLI向けアニメーションコンパニオンの公開ギャラリーです。READMEは三要素を説明します。(1) petdex.devのWebギャラリーでコミュニティがペットを提出・レビュー。(2) CLIが1コマンドでマシンへインストール。(3) デスクトップアプリが画面上にペットを浮かべ、コーディングエージェント活動に反応。各ペットはフォルダ1つがPokédexエントリ相当で、`npx petdex install`が入口です。言語タグTypeScript、ライセンスMIT、ホームページpetdex.dev、約4000スター（メタデータ時点）です。 追加段落：README一次情報に基づき、本リポジトリの公開範囲はドキュメントとソースに限定されます。star数やfork数はGitHubメタデータ由来の注目指標であり、機能保証やSLAを意味しません。導入判断では、READMEが示す具体コマンド・設定キー・バージョン番号を手元環境で再現し、期待する入出力が得られるかを記録してください。READMEに無い性能数値、互換マトリックス、セキュリティ監査結果は推測で補わず、issue/リリースノート/公式サイトで確認できる事実だけを採用記録に残します。

クイックスタート：bobaインストールからデスクトップ接続

READMEクイックスタート手順：(1) `npx petdex install boba` を実行し、`~/.petdex/pets/boba/`にpet.jsonとスプライトシートがあることを確認。(2) petdex.dev/downloadからデスクトップアプリを取得（macOS/Linux/Windows）。(3) ペット上でCmd+,でSettingsを開き、Petsでペット選択、Agentsでコーディングエージェントをワンクリック接続。ペットはワークスペース上に浮き、エージェントのツールコールごとにアニメーションします。READMEはCLIだけでは表示やエージェント接続は行わずデスクトップが担当すると明示しています。 追加段落：README一次情報に基づき、本リポジトリの公開範囲はドキュメントとソースに限定されます。star数やfork数はGitHubメタデータ由来の注目指標であり、機能保証やSLAを意味しません。導入判断では、READMEが示す具体コマンド・設定キー・バージョン番号を手元環境で再現し、期待する入出力が得られるかを記録してください。READMEに無い性能数値、互換マトリックス、セキュリティ監査結果は推測で補わず、issue/リリースノート/公式サイトで確認できる事実だけを採用記録に残します。

Monorepo構成とNext.js 16スタック

READMEアーキテクチャ節ではリポジトリ構造を公開しています。src/app/[locale]/がギャラリー、/pets/<slug>、/collections、/built-with、/create、/download、/submitなど。src/app/api/cli/がOAuth設定、zip提出、R2 presigned upload、register。src/app/api/manifest/が承認済みペット一覧。packages/petdex-cli/がnpmバイナリ。WebはNext.js 16、React 19、Tailwind、Drizzle、Postgres、Redis、Clerk、R2。CLIはBun+TypeScript、Clerk OAuth+PKCE。デスクトップはNative SDK、127.0.0.1:7777のZig hook server、WebView/Node sidecarなしとREADMEは述べています。 追加段落：README一次情報に基づき、本リポジトリの公開範囲はドキュメントとソースに限定されます。star数やfork数はGitHubメタデータ由来の注目指標であり、機能保証やSLAを意味しません。導入判断では、READMEが示す具体コマンド・設定キー・バージョン番号を手元環境で再現し、期待する入出力が得られるかを記録してください。READMEに無い性能数値、互換マトリックス、セキュリティ監査結果は推測で補わず、issue/リリースノート/公式サイトで確認できる事実だけを採用記録に残します。

pet.jsonと8x9/v2 8x11スプライト仕様

ペットパッケージはpet.jsonとspritesheet.webp（または.png）の2ファイルです。8x9グリッド各192x208px、またはv2の8x11グリッド。ネイティブレンダラはidle、running-right、running-left、waving、jumping、failed、waiting、running、reviewの9状態行をサポートし、v2 8x11は追加2行をクライアントが使えます。ビルダー向けHTTP API `petdex.dev/api/manifest` が承認済みペットのslug、スプライトURL、状態メタデータを返します。petdex.dev/built-withに21件の派生プロジェクトがREADMEで言及されています。 追加段落：README一次情報に基づき、本リポジトリの公開範囲はドキュメントとソースに限定されます。star数やfork数はGitHubメタデータ由来の注目指標であり、機能保証やSLAを意味しません。導入判断では、READMEが示す具体コマンド・設定キー・バージョン番号を手元環境で再現し、期待する入出力が得られるかを記録してください。READMEに無い性能数値、互換マトリックス、セキュリティ監査結果は推測で補わず、issue/リリースノート/公式サイトで確認できる事実だけを採用記録に残します。

CLI提出パイプラインとレート制限

packages/petdex-cli/README（リポジトリREADMEが参照）によると、submitはフォルダ/zip/親フォルダ一括の3入力形式を受け付け、POST /api/cli/submitでR2 presigned URL（60秒）を取得し直接アップロード、POST /api/cli/submit/registerでpending登録します。スプライトは1536x1872（8x9）または1536x2288（8x11）グリッドが要求されます。スラッグ衝突はboba-2のように自動回避。レート制限はユーザー24時間10回（管理者除外）。loginはClerk OAuth+PKCE、トークンはOSキーチェーン保存。v1.0.0でinit/up/down/toggle/desktop/update/doctor/hooksは削除されデスクトップ案内のみになったとREADMEは記載しています。

ローカル開発：bun run dev:docker

開発者向けに`git clone`後`bun install`、`bun run dev:docker`（Docker/Podman、約30秒ウォームアップ）でlocalhost:3000が開くとREADMEにあります。本番サービス向けは`.env.local`を埋めた`bun run dev`（maintainers only）。最新リリースはdesktop-v0.8.0、cli-v1.2.2（2026-08-13〜14）。ペットIPはユーザー投稿ファンアートで、権利者はtakedown.ymlで48時間以内レビューとREADMEは説明しています。

導入確認：install bobaとpet.json検査

採用前は`npx -y petdex install boba`を実行し、`ls ~/.petdex/pets/boba/pet.json`とスプライトファイル存在を確認します。Node 20未満やnpx確認プロンプトで止まる場合はREADME CLI節の対処（`-y`、Node 20+）を適用。表示確認はpetdex.dev/downloadのデスクトップ必須で、SettingsのAgentsでCodex等を接続後、エージェントでツールコールを1回発生させアニメーション遷移を目視します。提出を試す場合は1536x1872グリッドのPNGを用意し`npx petdex submit ./my-pet/`でAPI応答を確認してください。

ユーザー向け操作表とコミュニティ

README For users表：Browse petsはpetdex.dev、Installはnpx petdex install <slug>、Switch mascotはデスクトップSettings Cmd+,、Desktop floaterはpetdex.dev/download、Make petはCodex内hatch-petスキルまたはpetdex.dev/create、Submitはnpx petdex submit ./my-pet/またはWeb submitter、Discordはdiscord.gg/byhubdyBTe。CLI完全リファレンスはpackages/petdex-cli/README.md。Web提出はpetdex.dev/submit、Built with Petdexはissue template built-with.yml。Discordチャンネル#wip #ship-or-sink #cli-feedback #showcaseがREADMEに列挙。ペット資産は投稿者ライセンス、ソースMITとREADMEが区別しています。

編集部の結論

Codex/Claude Code/OpenCode/Gemini CLIユーザー向け。`npx petdex install boba`後に~/.petdex/pets/boba/pet.json存在を確認し、表示はpetdex.dev/downloadのデスクトップアプリでAgents接続が必要。CLI単体ではペットは浮かびません。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes