claudlet — สัตว์เลี้ยงเดสก์ท็อปพิกเซลที่แสดงภาพสถานะการทำงานของ Claude Code

เคยรู้สึกอึดอัดไหมเวลามองแต่ข้อความที่เลื่อนในเทอร์มินัล แล้วไม่รู้ว่า “ตอนนี้ Claude กำลังเขียนโค้ดอยู่ กำลังค้นไฟล์ หรือกำลังรอคำตอบจากเรา”
claudlet คือสัตว์เลี้ยงพิกเซลบนเดสก์ท็อปแบบตอบสนอง ที่แสดงสถานะการทำงานปัจจุบันของ Claude Code ได้อย่างเข้าใจง่ายและน่ารัก

ฟีเจอร์หลัก

• ซิงก์สถานะแบบเรียลไทม์: จับ Hook ของ Claude เช่น กำลังพิมพ์ อ่านไฟล์ กำลังคิด รอคำสั่ง แล้วแสดงออกทันทีผ่านท่าทางและสีหน้าของสัตว์เลี้ยง
• แสดงภาพซับเอเจนต์: เมื่อ Claude เรียกซับเอเจนต์ เพื่อนตัวจิ๋วใส่หมวกนิรภัยจะปรากฏตัว เดินตามไปมาและเลียนแบบการทำงาน
• โต้ตอบกับหน้าต่างและเอนจินฟิสิกส์: เมื่อไม่มีงานทำ มันจะเดินไปตามกรอบหน้าต่างที่กำลังใช้งานอยู่ หากใช้เมาส์จับโยน ก็จะลอยไปเป็นวิถีพาราโบลา และยังเหยียบขอบหน้าต่างเพื่อกระโดดได้ด้วย
• จับคู่ 1:1 ตามเซสชัน: หากเปิดหลายเซสชัน ก็จะมีสัตว์เลี้ยงหลายตัวปรากฏขึ้น เมื่อคลิกที่สัตว์เลี้ยง จะดึงหน้าต่างเทอร์มินัลของเซสชัน Claude นั้นขึ้นมาไว้ด้านหน้า

จุดเด่นทางเทคนิค (How it works)

• Zero-Asset (เรนเดอร์ด้วยโค้ดล้วน): ไม่มีทรัพยากรรูปภาพภายนอกอย่าง PNG เลย งานอาร์ตและแอนิเมชันทั้งหมด (เช่น เด้ง, บีบและยืด) ถูกวาดด้วยโค้ดโดยตรงในระดับพิกเซลผ่าน QPainter จึงใช้งานและปรับแก้ได้อย่างอิสระโดยไม่ต้องกังวลเรื่องไลเซนส์
• สถาปัตยกรรมแบบ non-blocking ที่ปลอดภัย: ใช้โครงสร้าง Hook → TCP 소켓 → 펫 프로세스 แม้สัตว์เลี้ยงจะปิดอยู่หรือเกิดข้อผิดพลาด ก็เพียงเชื่อมต่อล้มเหลวอย่างเงียบ ๆ โดยไม่รบกวนงานหลักของ Claude Code อย่างเด็ดขาด (รับประกัน invariant)
• การตรวจจับหน้าต่างเนทีฟข้ามแพลตฟอร์ม: เรียกใช้ API เนทีฟของแต่ละ OS เพื่อระบุตำแหน่งหน้าต่างอย่างแม่นยำและขึ้นไปยืนบนหน้าต่างได้ ในสภาพแวดล้อม Windows(Win32), macOS(Quartz), Linux(KDE Plasma/XWayland)

ตัวอย่าง

[IMG] เดโม 1
[IMG] เดโม 2
[IMG] เดโม 3

การติดตั้งและการรัน

pipx install claudlet && claudlet-install  

• เพียงสั่งคำสั่งเดียว Hook และสกิล /claudlet จะถูกลงทะเบียนให้อัตโนมัติแบบ idempotent
• หลังจากนั้น เมื่อเปิดเซสชัน Claude Code ใหม่ สัตว์เลี้ยงจะปรากฏขึ้นโดยอัตโนมัติ

---