Petdex: 1,003+ thú cưng pixel art miễn phí cho Codex CLI

TL;DR

Petdex là gallery công khai của animated companions dành cho OpenAI Codex CLI - do cộng đồng xây dựng, hoàn toàn miễn phí, MIT license. Hơn 1,003 thú cưng pixel art, mỗi con có 9 animation states phản ánh trạng thái agent real-time. Cài đặt bằng một lệnh: npx petdex install boba.

Vấn đề bạn đang gặp

Bạn chạy Codex để xử lý một task dài trong nền - refactor một module lớn, chạy test suite, generate code cho một feature phức tạp - rồi chuyển sang làm việc khác trong khi chờ. Và liên tục phải switch window để kiểm tra: Codex đang chạy chưa? Đã xong chưa? Hay bị kẹt ở đâu đó đang chờ input của bạn?

Đây là friction nhỏ nhưng xảy ra liên tục trong cả ngày làm việc. Context-switch mỗi 5-10 phút để kiểm tra trạng thái agent tốn không ít flow.

Petdex giải quyết vấn đề này theo cách đơn giản nhất có thể: một con thú cưng pixel art hiện dưới dạng floating overlay, thay đổi animation theo đúng trạng thái agent real-time. Đỏ = đang chờ input. Xanh = task xong. Animation chạy = đang làm việc. Không cần switch window, không cần mở thêm terminal.

Petdex là gì

Petdex là gallery cộng đồng cho phép bạn browse, preview và cài đặt các animated pet packs vào Codex CLI. Mỗi pet là 2 file:

• pet.json - metadata, danh sách animation states, frame durations
• spritesheet.webp - pixel art dạng lưới 1,536 x 1,872 px, 8 cột x 9 hàng

Khi chạy trong Codex, pet hiện lên dạng floating overlay, tự chọn animation tương ứng với trạng thái session hiện tại.

Cài đặt nhanh

Vào petdex.crafter.run, browse gallery, copy lệnh install và chạy trong terminal:

npx petdex install boba

Script tự fetch pet từ R2 CDN, đặt vào ~/.codex/pets/<slug>/ và cấu hình Codex dùng ngay. Hoạt động trên macOS, Linux, và Windows qua PowerShell. Không cần cài thêm gì ngoài Node.js.

Bạn cũng có thể dùng lệnh /hatch-pet tích hợp sẵn trong Codex để tạo pet mới bằng AI, hoặc submit lên gallery qua CLI sau khi tạo.

Tính năng chính

• 1,003+ companions - cộng đồng submit, admin review trước khi lên gallery
• 9 animation states per pet - idle, working, sleeping, paused, done, và các trạng thái khác
• Filter nâng cao - theo kind (creature / object / character), vibe (cozy / focused / mystical...), màu sắc, popularity
• Collections có chủ đề - GRAYCRAFT (mech IP gốc), Anime Heroes, và nhiều bộ khác
• Creator leaderboard + Discord community + admin spotlights
• Tự tạo pet qua /hatch-pet built-in trong Codex

So sánh với Claude Code Buddy

Claude Code Buddy đã chính thức bị retire, Petdex hiện là lựa chọn active duy nhất trong phân khúc này.

Hạn chế cần biết

• Codex-only - không hoạt động với Claude Code, Cursor, hay bất kỳ CLI nào khác
• Display-only - pet không có khả năng AI, không giúp bạn debug hay review code
• IP ambiguity - nhiều pet là fan art, cần cân nhắc trong môi trường doanh nghiệp
• Admin bottleneck - submission cần review trước khi lên gallery

Nên dùng khi nào

Petdex phù hợp nếu bạn thường xuyên chạy Codex agent cho các task nền dài - code generation, test suite, refactor batch - và muốn có status indicator trực quan mà không cần mở thêm terminal window hay liên tục switch context.

Nếu bạn quan tâm đến pixel art hoặc muốn đóng góp cho một open-source project đang tăng trưởng, đây cũng là nơi phù hợp. Mỗi community submission được review trước khi lên gallery, đảm bảo chất lượng nhất định. Gallery hiện có 770 GitHub stars, 34 forks, và tiếp tục tăng.

Nếu bạn dùng Claude Code, Cursor, hay bất kỳ AI CLI nào khác - Petdex chưa hỗ trợ. Nó chỉ chạy trong Codex. Hãy theo dõi GitHub để biết khi nào có update về cross-tool support.

Nguồn: GitHub crafter-station/petdex, petdex.crafter.run/about.